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CYCLE 5 HELPFUL HINTS 



This paper describes helpful hints or* how to use Cycle 5 of 
NOS/VE. It is Intended to supplement* rather than to replace* 
the standard NOS/VE documentation. If you have any questions or 
suggestions* please see lorn HcGee or Bonnie Swierzbin. Appendix 
lists background documents and hot* to obtain them. 

To obtain additional copies of this document while running on 
SHI 01 at Arden Hills* please types 

SES*INT1.LISTHIHTS €=<numfeer of coples> 

To obtain a copy with revision bars against the Helpful Hints 
of the previous build* one can type* 

SESflNTl.LISTHIHTS REVB C»<nu»ber of coples> 

The C parameter is optional and defaults to one. 

Date Changes 

12/22/80 Revisions for NOS/VE Phase C 

2/12/81 Additional Revisions for NQS/VE Phase C 

6/09/81 Revisions for NQS/VE Build N 

6/19/81 Additional Revisions for NOS/VE Build N 

8/28/81 Revisions for NOS/VE Build 

11/06/81 Revisions for NOS/VE Build 9 

3/01/82 Revisions for NOS/VE Build 

4/15/82 Revisions for NOS/VE Cycle 2 

5/01/82 Revisions for NOS/VE Cycle 3 

6/30/82 Revisions for NOS/VE Cycle 5 
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The TAFNVE operator command { TAF control point) is no longer * 

required or available. The capabl I I t les that were provided fey ! 

It have been packaged within the NVE subsystem control point. I 

The impact of this change Is as follows: \ 

- The K display is assigned to the same control point * 
during both deadstart and normal system operation* ! 

- Output from the system core debugger will no longer J 
appear at the NVE control point K-display. All system » 
core debugger communication Is via the HOD terminal. * 

The K.+BYEVE. command Is no longer available. » 

- The 2.QFFSW6, command before doing a 2.ST0P. is not J 
required to bring NVE down* J 

- All capabilities are available yla the N.NVExxxx. * 
command* The NVE subsystem may be placed at any control J 
point ( like NAH Is). *. 

Cycle 5 (actually Cycle 4) of NOS/VE no longer supports the J 

"old** command names for system commands. Both "old" and "new** ! 

names have been supported since Build Q. See DAP ARH4776 for J 

details. As part of this change the abbreviations for the 1 

C0PY_FILE and PRINT.FILE commands have been corrected to COPF J 

and PRIF <from COPYF and PRINTF). S 

The EXPLAIN command was implemented in Cycle 4 of NOS/VE* • 

Don't get too excited about this* however* because as yet * 

there are no "explain level** message templates for any of the * 

system conditions. EXPLAIN will simply regurgitate the J 

regular message. % 



While implementing the EXPLAIN command it was discovered that 
the specification of the command (i.e. that it have an 
optional "condition" parameter) was not nearly as useful as 
having the first parameter be a "status" value. So the 
implementation deviates from the ERS in that the first 
parameter to EXPLAIN is MESSAGE. STATUS or HS and is of kind 
STATUS. The SSTATUS function can be used to transform a 
"condition" into a "status". A DAP is being written to make 
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this change official. * 

The implicit attach process has been modified to choose share * 

mode to be the following function of access mode* If access * 

mode includes shorten* append or modify then share mode is I 

none* otherwise share mode is read and execute. This results » 

In allowing sharing of implicitly attached files that are not ! 

being written but inhibiting sharing of implicitly attached J 

files that are being written. I 

The implicit attach process formerly chose share mode to be * 

the share requirements established by the permit mechanism. J 

The owner of files typically has no share requirements and * 

hence would implicitly attach the files for exclusive access* S 

This created a severe usability problem for code or command * 

files that were to be executed by multiple jobs* « 

It seems that many people are running into a problem on the 
system concerning the use of "path" references to files* 
Specifically* a job will "hang M if a CREATE.FILE (define) or 
ATTACH_FIIE (attach) command for a file is followed by by 
another reference to the file using the "path** notation* For 
exampl e* 

CREATE.FILE SUSER.JUNK 



C0PY_FILE $USER.JUNK NEWJUNK 

will result in the job begin hung* The reason Is that there 
is a LQCAL_FILE_NAME parameter on the create.fi le command 
which defaults to the name of the permanent file (In the 
examples JUNK); but the "implicit" access to the file via the 
copy_flle command uses an internally generated local name for 
the file* Thus* the effect is the same as the following 
command sequence on NOSs * 

DEFINE. JUNK. 



ATTACH* zuni que- JUNK. 
C0PY»zuniqu8*NEyJUNK. 

Here* the job will hang on the attach command because of 
conflicting access to file JUNK. 

On NOS/VE, explicit use of the CREATEJ=Il£ and ATTACH.FILE 
commands is not generally necessary* For examples 
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COPY. FILE .MY_FRIEND.$OME_FIL£ SUSER* SOME.FILE 

Hill (Implicitly) attach file SOME.FILE from user MY_FRIEND f s 
master catalog* create file $0ME_FILE in my master catalog and 
copy the former Into the latter (If SQME.FILE already existed 
in my master catalog* it would be attached and overwritten)* 

00 NOT NIX "IMPLICIT" ATTACH/CREATE WITH "EXPLICIT" 
ATTACH/CREATE* 

If you insist on explicitly attaching or creating files then 
USE THE LOCAL FILE NAME that you assigned via the ATTACH.FILE 
or CREATE_FILE command* 

Sheldon Fewer is writing a DAP proposing to change the default 
for the LOCAL FILE NAME parameter on the CREATE_FILE and 
ATTACH_FILE commands* If sanity prevails* this DAP will be 
approved and the problem outlined above will be largely 
resolved. Until then PLEASE USE EITHER EXPLICIT ACCESS OR 
IMPLICIT ACCESS (preferably the latter) BUT NOT BOTH!!! 

With the advent of HOS/VE Cycle 1.3.4 SCU command and 
parameter names were updated per DAP 4968. Only the new names 
are recognized now. Documentation for the current version of 
SCU can be found In the ERS# DCS number ARH3883 revision F. 
Command summaries can be obtained from Mike Perreten in Ar den 
Hills or Stacy Buckley in Sunnyvale. The material accessed by 
the non-standard command di spl ay„.command_inf ormat I on has been 
updated for SCU. The use of di sp I ay_command_l i st with 
di spl ay^opt ions equal to full while inside SCU may prove 
useful . 

An EOI problem exists with respect to a file shared between 

jobs. An existing file is opened with an access mode of 

append by job A. The same file is opened with an access mode 

of read by job 8. Job A extends the file and either 

explicitly closes the file or terminates. Job B explicitly 

closes the file or terminates. In this case, since the job 

accessing the file in read mode terminated after the job which 

extended the file* EOI on the file will be reset to the 

original position and the result of the extend will be lost. 

The Interstate Communication Facility, which is described in 
Section 9 of the NOS/VE ERS - Program Interface (Rev. 8)* has 
been implemented. The callable subroutines described in 
section 9.3 reside in User Library LINKLI8 in the Integration 
catalogs INT1* DEVI. REL1* etc. NQS libraries SYSLI8 and 
5RVLIB are also required to complete the loading process* 
LOSET loader commands must be used to select these libraries. 
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Interactive Usage Restrictions: 

- When logging in to NOS/VE U*e* HELL0#TAF etc.) do not 
enter a terminate break CCTRl t) or a pause break (CTRL pi 
before the 'welcome passage 1 appears at the terminal* A 
pause or terminate break entered before the interactive 
NOS/VE job has completed it*s initialization may crash the 
system* 

- A REQUEST.TERNINAL command in a batch job will crash the 
system* This can happen accidently through a 
REQUE$T_TERNINAL command in a user prolog when the user 
runs a batch job since the prolog is executed for both 
interactive and batch jobs* The problem can be avoided by 
making the REQUEST.TERMINAL command in the prolog 
conditional on the job type as follows* 

IF $JQB«MQDE) <> 'BATCH* THEN 

REQUEST. TERNINAL 
IFEND 

Any product or utility that is placed in the SSYSTEM catalog 
(or any frequently loaded program) should be bound using the 
CREATE. HODULE subcommand of the CREATE. OBJECT.LIBRARY 
utility* This will minimize overhead associated with loading 
the product or utility* 

Debug responds to terminal breaks when a program is being 
debugged* However* entering a pause or terminate break when 
debug is active (i*e* the 08/ prompt has appeared and the 
user has not issued the RUM command) will cause the task to 
termi nate* 

When sharing executable files via permanent files <i*e# 
compilers* libraries* etc*) you should make the file an 
object library via the CREATE. GBJECT.LI8RARY utility. By 
sharing object libraries instead of object files* the code Is 
actually shared among all tasks using the library! the library 
is not copied to another segment but is executed directly* 



1*1 tlQSm-USAiifc-EXAliRLfS 
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1.1.1 EXECUTING PROGRAMS 

PROCESS 

Create an object text file by compiling a program on NQS. 
Then perform the following steps on NOS/VE* 

- Acquire any necessary libraries (which are qq£ quoted In text 
embedded directives) by either* 

o Attaching them from the system catalog* either explicitly 
or via prolog 

or 
o Creating the library file via the object library generator 

or 
o Staging the library file from NQS to NOS/VE using the 
GET.OSJECT.LIBRARY command. 

Get the file from NQS and convert the object text file from 
the CI data mapping to II data mapping by executing the 
CQNVERT.OBJECT.FILE command. 

Load and execute the program via the EXECUTE.TASK command* 
specifying the necessary libraries with the LIBRARY parameter; 
alternatively SET.PROGRAH.ATTRIBUTES may be used to include 
the libraries in all subsequent EXECUTE.TASK commands. 

- Stage the loadmap from NGS/VE to NOS for printing by using 
ei ther J 

o The REPLACE.FILE command with A6 conversion mode specified 
if running on the simulator. 

or 
o The PRINT.FILE command if running on the hardware. 

EXAMPLES 

The following is an example command sequence for executing a 
program not requiring any libraries for loading: 

Assumptions! all modules to be loaded are contained on the NOS 
permanent file » citxtrs*. 

CONVERT.OBJECT.FILE CITXTRS 

EXECUTE. TASK CITXTRS PARAMETER-* pr ogr am parameters* 

PRINT. FILE LOADMAP 5 
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The following is an example command sequence for executing a 
program requiring libraries for loading: 

Assumpt ions* the NOS permanent file •citxtrs* contains object 
text generated fey the CY8IL CI compiler* The compiler modules 
reference procedures contained on the Horary •mylib 1 and the 
CYBIL run-time library. These libraries have been generated on 
NOS/VE and saved on NOS. 

SETJ3BJECT_LIBRARY HYLI8 

SET.PROGRAH.ATTRIBUTES LGAD_MAP_0PTI0NS= i BLOCK* £NTRY_P0I NT * SEGMENT 

CONVERT.OBJECT^FILE CITXTRS 

EXECUTE. TASK CITXTRS 'program parameters' LIBRARY»MYLI8 

PRINT_FILE LOADMAP 

X.1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 

o CLG0170 is NOS permanent file name for file containing CI 
object text for modules to be included in the library. 

o IITEXT180 is NOS/VE local file name for file containing II 
object text for modules to be included in the library. 

o LI8RARY18G is NOS/VE local file name for the library being 

created. 

o ILIB170 is NOS permanent file name for file containing the 
I i brar y. 

NOS/VE Job Commands 

C0NVERT_08JECT_FIL£ IITEXT180 CLG0170 

CREATE_OBJECT_LIBRARY 

ADD_MODULE LI8RARY*IITEXT180 

GENERATE.LI8RARY LIBR ARY*LI8RARY180 

QUIT 

REPLACE.FILE LI8RARY180 ILI8170 DC=B56 

1,1.3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 

o ILIB170 is NOS permanent file name for file containing the old 
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1.1.3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 



! ibrar y 

o LIBRARY180 is NOS/VE local file naie for file containing the 
old I i brary 

o CM0D170 is NOS permanent file name for file containing CI 
object text for the new module 

o NEWIIHQDULE is NOS/VE local file name for file containing II 
object text for the new module 

o NEWLIBRARY is NOS/VE local file name for the library being 
created 

o NLIB170 is NOS local file name for new library 

NOS/VE Job Commands 

QET.08JECT. LIBRARY LIBRARY180 ILI8170 
CONVERT.OSJECT.FILE NEWIIMODULE CM0D170 
CREATE.08JECT.il BRARY 
AOD.MODULE LI8RARY»LIBRARY180 
REPLACE. MODULE LI8RARY=NEWI IMODULE 
GENERATE. LIBRARY LIBRARY-NEWLIBRARY 
QUIT 
REPLACE.FILE NEWLIBRARY NLIB170 0C-B56 

1.1.4 ROUTE AH INPUT FILE FROM NOS TO NOS/VE 



Running from an interactive terminal* enters 

GET.f i iename. 

R0UTE»fi lenawe>DC*lP»FC»RH. 

The input file which is sent to NOS/VE must be in 6/12 ASCII 
(or display code subset). The job file must be a single 
partition NOS record containing NOS/VE commands* The first 
statement must be a valid LOGIN command with user* password and 
family name specified. Multi partition input files are not 
supported by NOS/VE so NOS data files used by the program must be 
obtained through the GET.FILE command. 
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1.0 MAJOR CHARACTERISTICS OF THIS 8UTLD 
1.1.5 PRINT A NOS/VE FILE 

1.1.5 PRINT A NOS/VE FILE 

At NOS/VE job termination the job log will be automatically 
returned to NOS. The job log nil I be appended to the NOS/VE 
output file OUTPUT. NOS/VE print files must be written by BAM as 
8/8 ASCII RT=V. Print files Mill be converted from 8/8 ASCII 
RT-V to NOS 8/12 ASCII when they are sent to NOS and will be 
printed in upper/lower case. 

All NOS/VE output files will appear in the NOS output queue 
(NOS H*0 display) with the name IRHFxxx as a banner. In order to 
print a NOS/VE file* the following command must be issued within 
your job or be entered from the system console via the operator 
f ac 1 1 i ty: 

PRINT_FIL£ filename 
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2.1.1 LOGIN TO NOS/VE 



To initially login to NOS/VE via TAF* you must cause the first 
login attempt to fail. This can be done by responding to the 
**FAMILYs w login prompt with something likes •••••**» This must be 
done because the system will try to connect the terminal to IAF 
on the first login attempt no matter what is typed* To access 
TAF do the fol lowing on the second "FAHILYs** prompt? 

• user t passwordfTAF 

You can access TAF from IAF by doing w HELL0»TAF w or by 
answering TAF to the system prompt "APPL ICATIONs** 

2.1.2 TERMINAL USAGE 



1) The slant C/) is the prompt to enter a NOS/VE command. Any 
normal NOS/VE command can now be entered (continuation 
lines are prompted with ••/)• The full ASCII character 
set* lower or upper case and all special characters* can be 

used. 

2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NOS/VE Interactive Job can then be 
started by responding to the •APPLICATIONS* prompt with 
TAF. 

3) Terminal breaks (control-t and control-p) can be used to 
terminate a task or command and suspend a task and enter a 
new task to process SCL commands. Control-t causes a 
terminate break and control-P causes a pause break. 
Terminate break will terminate a command or the most 
recently executed task. A pause break will suspend 
execution and allow commands to be entered. When a 
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2.1.2 TERMINAL USAGE 



terminal is in pause break state* two additional commands 
are aval I ab I e: 

RESUHE.CQHMANO - resume execution at the point of 
interruption. 

TERMINATE. COMMAND - cause a terminate break condition as 
a terminate break had been entered. 

Both terminate break and pause break are available to programs 
as conditions via the program management condition mechanism* 



2.1.3 NQS/VE PROGRAM ACCESS TO THE TERMINAL 



1) Interactive NOS/VE jobs are able to obtain terminal input 
through the AMP$G£T_NEXT or AMPSGET. PARTIAL program 
interface which can foe used by both task services and user 
ring programs. Interactive programs which use this 
interface should be able to handle both upper and lower 
case input in order to make them more convenient to use in 
both 64 and 96 character set modes* 



2.2 tQfll!S&Ba-AMfl-£aEA!S£IE&-fclAttES 

During the next few months a command supported by the system 
may not be in sync with your command interface document* The 
parameter descriptor table gives an accurate* concise description 
of the command interface as currently supported* 

The definition of a command's parameter list is enclosed in 
parenthesis with a parameter description per line* Each 
description has the general form: 

PARAMETER NAME* ALLOWED PARAMETER VALUES - PARAMETER DEFAULT 
VALUE 



Parameter Names - describes the parameter name and any 
abbrevlat ions. 

ALLOWED PARAMETER VALUES - describes the kind of value allowed 
and whether a list of values is possible* The value kind can be 
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2.0 COMMAND INTERFACE STATUS 
2.2 COHHANO AND PARAHETER NAMES 



further qualified. In some cases* the actual values allowed are 
described using the KEY notation* The value kinds include 
INTEGER* STRING, NAHE, FILE* STATUS. 



PARAHETER DEFAULT VALUES - describes the defaulting rules 
and/or values for the parameter. SREQOIRED and $0PTI0NAL are 
obvious. Other values In this position Mill be treated as if 
they were entered by the user on command invocation. 



See the 
det ai Is. 



PROC command 



n the Command Interface ERS for more 



The PDTs for the commands currently in the system can be 
displayed using the DISPLAY_CQMNANB..INFORHATION command. This is 
documented in the nonstandard command section of this document. 



2.3 CQJWAoa-EliBCIIQHS 



Euaatiaa 

SHOD 

$CHAR 

SCHICK 

SDATE 

SFILE 

SFNAME 

SINTEGER 

$NAHE 

$QR0 

$REAL 

$STRING 

SSTRLEN 

SSTRREP 

SSUBSTR 

SUNIQUE 

$TIHE 

$VAR 

$SPECIFIEO 

SSET.COUNT 

$VALUE_CQUNT 

$RANGE 

SPARAHETER.LIST 

SPARANETER 

SSTATUS 

SCONDITIQN 

$SEVERITY 

SPROCESSQR 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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SJQ8 
$PROGRAM 



unchanged 
unchanged 



2.4 SmEtL.AC£ESS-CQflHAMM 



SET_LINK_ATTRIBUTES 

LOGIN 

LOGOUT 

SET_PASSWQRD 



SiaJtus 

unchanged 
unchanged 
unchanged 
unchanged 



- *1 



#1 The family name of the job doing the submit Mill be used as 
the default family name on batch jobs. The default for jobs 
submitted from NOS all! be family SSYSTEM. This effectively 
means that whenever NOS/VE jobs are submitted from NOS the 
family parameter is required* 



2.5 fcESQUEtE.ISAaAfiEHEIil 



fLfijnoAfld 

REQUEST.TERMINAL 



Siaiii* 
unchanged 



2.6 EILE-MMA££iS£MI 



Causa oil 

SET.FILE. ATTRIBUTES 

COPY.FILE 

DISPLAY_FILE 

COMPARE. FILE 

DISPLAY.FILE. ATTRIBUTES 

SKIP.TAPE 



Italy* 

unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



2*7 EE&flAMESI-EILE-aAMASEttEMI 
CsiiaujI 

GET_FILE 

REPLACE.FILE 

CREATE.FILE 



Staias 

unchanged 
unchanged 
unchanged 
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2*0 COMMAND INTERFACE STATUS 
2»7 PERMANENT FILE MANAGEMENT 



ATTACH.FILE 
DELETE. FILE 
CHANGE.CATALOG.ENTRY 
CREATE.FILE. PERMIT 
9ELETE.FILE. PERMIT 
CREATE.CATALGG 
QELETE.CATALOG 
DELETE.CATALOG.PERMIT 
GREAT E.PERMIT.C AT ALOG 
DISPLAY.CATALOG 
DISPLAY.CATALOG. ENTRY 
SET.^QRKING.CATALOG 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



2 * 8 S£i_iIAI£fiEliIS- ASQ-EBfltEQURES 

PROC/PROCEND 

SET.COMMAND.LIST 

OISPLAY.COMMAND.LIST 

REPEAT/UNTIL 

WHILE/liHILEND 

CREATE. VARIABLE 

DELETE. VARIABLE 

BLOCK/BLQCKEND 

LQOP/LOOPEHD 

FaR/FQREND 

IF/ELSEIF/ELSE/IFENO 

CYCLE 

EXIT 

HHEN/WHENEND 

CONTINUE 

CANCEL 

INCLUDE. FILE 

COLLECT. TEXT 

DISPLAY.VALUE 

EXIT.PROC 

ACCEPT. LINE 

INCLUDE. LINE 

CREATE.FILE.CQNNECTION 

OELETE.FILE.CONNECTION 

DISPLAY.FILE.CONNECTION 

change HCS variable 

display HCS variable 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2.0 COMMAND INTERFACE STATUS 
2,9 INTERACTIVE COMMANDS 



2.9 laiEaACIME-CatifiAHDS 

Caiaiind Status 

RESUME.COMMAND unchanged 

TERMINATE.CQMMAND unchanged 

SET.TERHINAL.ATTRISUTES unchanged 

QISPLAY.TERMINAL.ATTRIBUTES unchanged 

esc-e new — 1* 

esc-l new - I* 

esc-j new - 1* 

esc-t new - 1* 

esc-x new - 1* 

*1 These commands are entered with the 3-key sequence* 
escape. key* character* car r i age.r eturn« The characters have 
the following meanings! 

e perform **disp I ay.job. status** command 

1 perform w displ ay. I og 10 w command 

j perform "displ ay. job. status all** command 

t discard all unprocessed* typed-ahead input 

x terminate job* but do not disconnect 

2.10 MAECI-CQflE-ilAItilEliAliCE 

CfissAQil Status 

C R EAT E.OBJECT. LIBRARY unchanged 

DISPLAY_N£w_LIBRARY unchanged 

SELECT.DI SPLAY. OPTION unchanged 

ADD.MODULE unchanged 

REPLACE. MODULE unchanged 

C0M8INE.MQDULE unchanged 

CREATE. MODULE unchanged 

BIND. MODULE unchanged 

GREAT E.PROGR AM. DESCRIPTION unchanged 

DELETE. MODULE unchanged 

CHANGE.M0DULE.ATTRI8UTE unchanged 

SATISFY JEXTERNAL.REFERENCES unchanged 

REORDER.MODULE unchanged 

GENERATE. LIBRARY unchanged 

DISPLAY.08JECT.LIBRARY unchanged 

COMPARE. OB JECT.LIBRARY unchanged 

QUIT unchanged 

CI to II Conversion unchanged 
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2,0 COMMAND INTERFACE STATUS 
2.11 USER SERVICES 



2.11 USEBL-SEBSilCES 

DISPLAY.LOG 
DISPLAY.HESSAGE 



unchanged 
unchanged 



2.12 ElLE-RQUIIIifi 
Caaaaai 

HCS JMRQUTE 



Status 



r emoved 



2.13 £EOS£All-£^£CyilQM 
(Lasiaad 

SET.PROGRAH.ATTRIBUTES 

QISPLAY.PRQGRAH 

EXECUTE 

"na^e cat I" 

TASK/TASKENO 

TERMINATE. TASK 

WAIT 

SET_QE8UG_RING 

OISPLAY.ACTIVE. TASKS 



SlatUi 



new 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

new 



- *3 
anged 
anged 
anged 
anged 
anged 
anged 
anged 

- *2 



- *1 



*1 Warning - "name call" works only for SCI procedures unless a 
SETFA command has been Issued to specify that the 
FILE. CONTENTS are OBJECT and the FILE.ORGANIZATXON is DATA or 
LIBRARY* The SETFA command must be reissued every time the 
file is brought over from NGS. The CQNVERT_OBJECT_FILE# 
GET_QBJECT_FILE> and GET.OBJECT.LIBR ARY nonstandard commands 
issue the appropriate SET_FILE_ATTRI8UTES command and are 
therefore recommended* 

*2 Replace HCS TSTATUS command. 

*3 Replaces SET.QBJECT.LIST and SET_PRQGRAH_OPTIONS commands. 



2.14 ifla.flAliAfi£fiiEliI 

Cfliiacd 

SUBMIT.JOB 
DISPLAY. JOB.STATUS 



unchanged 
unchanged 



Cycle 5» July 1982 



NOS/VE Cycle 5 Helpful Hints 



2*8 
07/07/82 



2.0 COHHAND INTERFACE STATUS 
2,14 JOS HANAGEMENT 



TERNINATE.JQB unchanged 

PRINT.? HE unchanged 

TERHINATE_PRINT unchanged 

DISPLAY_PRIMT_$TATUS unchanged 

2.15 nflS^£.£fl!lflAt!QS-Ifl£LEa£tlI£Q-AS-£&flCS 

In this build* several NOS/VE commands have heen Implemented 
as SCL procedures in order to make the system look more like the 
final version. Users are urged to use these procedures rather 
than their interim counterparts since the interim commands Mill 
ultimately be withdrawn. 

These procedures will be made available via the default system 
prolog. 

2.16 &QM-SIMME&-CQI3MMBS 



The following commands provide a nonstandard means of 
performing various frequently performed functions. They will be 
superceded in subsequent builds by standard commands and 
capabi I i t I es. 



2,16,1 0ELETE.CATALQ6_CQNTENTS J DELCC 

The purpose of this command is to delete all entries from the 
specified catalog. This includes subcatalogs and the files they 
contain. 

del ete.catal og.contents Ccatalog 5S <catalog>3 

Cstatus«<status variable>3 

catalogue: This parameter specifies from which catalog all 
files are to be deleted* Omission will cause 
the current working catalog to be used, 

status: See ERROR HANDLING. 
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2.0 COMMAND INTERFACE STATUS 

2.16.2 QISPLAY_ACTIV£_TASK ! DISAT 

The purpose of this command is to display task statistics for 
all currently active tasks in a job. The following information 
is displayed. 

task name 

execution time use 
number of page faults 

d I spl ay.act i ve_task Coutput*<f I 1 e>3 

Cst atus«<status variable>1 

output*©! This parameter specifies the file to which the 
task statistics is displayed. Omission Mill 
cause $ OUT PUT to be used* 



2.16.3 OISPLAY^SYSTEM.DATA S DISSD 

The purpose of this command is to display system page fault 
statistics and system monitor request statistics. 

di spl ay_system_data Edi spl ay_opt ion«page_f aul tsl pf 

* moni tor ..requests Jmr *al I 
Cdi spl ay_f ormat=i ncremental ' i * tota I * 1 3 
toutput»<f i le>3 
tstatus=<status variabie>3 

d ispl ay.opt ion J do: This parameter specifies which 

statistics are to be displayed. The 
following options are allowed s 

page.faults - display the page 

fault statistics. 

monl tor_requests - display the system 

monitor request 
statistics* 

Omission will cause ALL to be 

used. 

d isp I ay_f ormat Jdf s This parameter specifies whether a 

display of the all statistics recorded 
so far (total) or only those statistics 
recorded since the last 
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2,0 COMMAND INTERFACE STATUS 

di spi ay. system. data command 

(incremental) should be displayed* 
Omission will cause incremental to be 
used* 

outputlo: This parameter specifies the file to 

which the system data will be 
displayed* Omission will cause SQUTPUT 
to be used* 

status* See ERROR HANDLING* 

2.16.4 DISPLAY.J08.DATA ! DISJO 

The purpose of this command is to display the following job 
rel ated stati sti ess 

time in job node 

time in monitor mode 

count of page in operations 

reclaimed pages 

new pages ass I gned 

working set size 

count of ready tasks 

di spl ay.job.data Idi spl ay.opt I on* job.datal 

Cdispl ay.f or mat* Incremental M J total * 1 3 
£output*<f ile>] 
Cstatus*<s tatus varlable>] 

d ispiay.opt ion* do* This parameter specifies which 

statistics are to be displayed* The 
following options are allowed* 

job. data - display job related data* 

Omission will cause job. data to be 
used* 

d isp I ay.f ormat J df : This parameter specifies whether a 

display of the all statistics recorded 
so far (total) or only those statistics 
recorded since the last di spl ay. job. data 
command (incremental) should be 
displayed* Omission will cause 
incremental to be used* 
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2*0 CQMNANO INTERFACE STATUS 
2.16*4 OISPIAY.JOB.OATA I OISJD 

m m mm m m m m m mm m m m'm m mm m m mm m mmm mm m m mmm m m *»m m mmmmm mmtmtm mm mm mm m m mmmm mm mmmm m m m 

©utput'os This parameter specifies the file to 

which the job data will be displayed* 
Omission will cause SOUTPUT to be used. 

status? See ERROR HANDLING* 

2*16*5 DISRLAY.CGHHAND.I^FGRHATIGN \ DISCI 

The purpose of this command is to display current information 
about a NOS/VE command* The parameter names* abbreviations* 
allowed values and known problems for a command* as supported in 
the current system*' can be determined* This is a nonstandard 
command and will be replaced by the help utility sometime in the 
future* 

d I spl ay_command_inf or mat ion command_name*<name> * a) I 
Cut i I i ty_name-create_ob ject.l i braryl 

col Jsour ce_code_ut Hity*scu?systemJ 
Cdi spl ay _opti on* parameter _d esc r ipt ion„tabl e! 

pdt 'notes .names* he I pi 
Coutput*<f i I e referenced 
tstatus=<status variable>l 

command_nameJ en: This parameter specifies the name of the 

command about which information is to be 
disp I ayed* 

uti I i ty_name?un: This parameter specifies which utility the 

command belongs to* Omission will cause 
SYSTEH to be used* 

dl spl ay. option 'do? This parameter specifies the type of 

display being requested* The options ares 

par ameter_descr ipt lon_table*pdt - selects 
a display of the parameter descrip- 
tion table used by the command when 
executed* 

notes - selects a display of any known 
problems with the command* 

names - selects a display of the command 
names for a uti I i ty* 

help - selects a display of the command 
interface description of the command* 

Cycle 5# July 1982 



2-12 
NOS/VE Cycle 5 Helpful Hints 

07/07/82 , 

2.0 COHNAND INTERFACE STATUS 

2,16.5 DISPLAY^COHMAND^INFORJUTION I DISCI 



Omission will cause POT to be used. 

output*©* This parameter specifies the file to which 

information will be displayed* Omission 
will cause SOUTPUT to be used* 

status: See ERROR HANDLING. 

2.16.6 CQNVERT.OBJECT.FILE \ CONQF 

The purpose of this command Is to get a NOS/VE object file 

produced on NOS and to convert it to an object file suitable for 

processing by the NOS/VE loader or object code maintenance 

c ommands . 

conver t.ob ject_f i le to=<file reference> 

Cf r om-<name>3 
tuser-<name>l 
Est atus*<status variabie>l 

toSts This parameter specifies the NOS/VE file name on 
which the converted object file is to be written* 

fromifs This parameter specifies the name of the NOS file to 
be converted. This is the permanent file name as 
defined in the NOS file system and can be up to seven 
characters in length. 

Omission will cause the permanent file name of the 
TO parameter to be used* 

user'us This parameter specifies the NOS user identification 
of the owner of the file* This parameter is only 
neccessary if the file Is in a catalog other than the 
user who was specified by the most recently issued 
SET^LINK.ATTRIBUTES command* 

status: See ERROR HANDLING* 

2.16.7 G£T_OBJECT_FIL£ J GETOF 

The purpose of this command Is to get a previously converted 
NOS/VE object file from the NOS side and sets the appropriate 
file attributes that will allow the object file to be used by 
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NOS/VE. 

get.ob ject_f H e to*<file reference> 

£from*<name>3 
Cuser»<name>3 
tstatus a <status variabte>3 

toSt* This parameter specifies the NOS/VE file name of the 
object file. 

fromlfs This parameter specifies the NOS file name of the 

object file* This is the permanent file name as 

defined in NQS and can be up to seven characters in 
I ength. 

Omission Hill cause the permanent file name of the 
TO parameter to be used* 

user'u* This parameter specifies the NOS user identification 
of the owner of the file* This parameter is only 
necessary if the file is in a catalog other than the 
user who was specified by the most recently issued 
S£T_LINK_ATTRIBUTES command. 

status: See ERROR HANDLING. 

2.16.8 GET.OBJECT.LIBRARY I GETDL 

The purpose of this command is to get a previously created 
NOS/VE object library from the NQS side and set the appropriate 
file attributes that will allow the object library to be used on 

HOS/VE. 

get_ob ject_! itorary to*<flle reference> 

tf rom»<n ame>3 
tuser~<name>3 
Cstatus*<status variable>3 

toJts This parameter specifies the NOS/VE file name of the 
object I ibr ary. 

froni'fs This parameter specifies the NOS file name of the 
object file. This Is the permanent file name as 
defined in NOS and can be up to seven characters in 
length. 

Omission will cause the permanent file name of the 
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2.0 COWHAND INTERFACE STATUS 

TO parameter to be used* 

userSu* This parameter specifies the NOS user identification 
of the owner of the file* This parameter is only 
necessary if the file is in a catalog other than the 
user who Has specified on the most recently issued 

SET.LINK. ATTRIBUTES command. 

statusi See ERROR HANDLING* 

2.16*9 DISPLAY.OBJECT.TEXT ? DISOT 

The purpose of this command is to produce a formatted display 
of the object text contained in an object file or object library 
produced on NOS/VS. 

di sol ay.ob ject.text file*<file> 

Coutput*<f i I e reference>3 
Cstatus-<status variable>3 

f 1 1 e * f s This parameter specifies the object file or object 
library containing the object text to be listed* 

output \ o: This parameter specifies the file to which the 
display Is to be written* 

Omission will cause the file $QUTPUT to be used* 

status: See ERROR HANDLING* 

2.16.10 GET. SOURCE. LIBRARY ! GETSL ! 

The purpose of this command is to get a previously created SCU * 

source library from the NOS side and set the appropriate file • 

attributes that will allow the source library to be used on * 

NOS/VE* \ 

get. source. I i brary to-<file reference> S 

Cf rom-<name>3 % 

I user=<name>3 * 

tstatus*<status variable>3 1 

tolts This parameter specifies the NOS/VE file name of the * 
source I ibr ary* ! 
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2.0 COHHAMO INTERFACE STATUS 

fromjf* This parameter specifies the NOS file name of the 
source library* This is the permanent file name as 
defined in NOS and can fee up to seven characters in 
I ength. 

Omission will cause the permanent file name of the 
TO parameter to be used. 

userlus This parameter specifies the NOS user identification 
of the owner of the file* This parameter is only 
necessary if the file is in a catalog other than the 
user who was specified on the most recently issued 
SET_tINK_ ATTRIBUTES command, 

status: See ERROR HANDLING. 

2.16.11 EDIT.FILE J EOIF I 

The purpose of EDIT.FILE is to Initiate the execution of the 
SCU editor on a text file. (For details see ARH3883.J 

edit. file » edif - edit lines on a source file. (procedure file * 
not necessarily In its final form) 

aa£.aoifitar.s. dsfaults 

f I le»f i le(source) $REQUIRE0 

Cresult*f i le(source)! SVALUE(FILE) 

Cinput*file reference 1 SCOHHAND 

Coutput*file reference] SOUTPUT 
Cstatusl 

2.16.12 JEOIT 

The purpose of this command is to initiate execution of the 
JEDIT editor built by Jack Bohnhoff. Anyone wanting information 
about the editor should contact Jack. 

jed i t from=<f i I e> 

£status»<status variable>3 

fromjf: This parameter specifies the file to be editted. 
This file is rewritten after the editor 
terminates • 
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2.0 CGNHAND INTERFACE STATUS 
2*16.1?. JEDIT 

status? See ERROR HANDLING in the NOS/VE Command 
Interface. 



2.16.13 DEBUG 

The prototype Rl NOS/VE debugger is now available. Details on 
hoa to use the debugger can be found in the "CYBER 180 
INTERACTIVE DEBUG External Reference Specification and User's 
Guide w * Sunnyvale DCS number S4028. 

2.16.14 SET.LINK.ATTRIBUTES X SETLA 

The SET_LINK_ATTRIBUTES command is the same as documented in 
the NOS/VE command interface with the exception that the CHARGE 
and PROJECT parameters are optional (and in fact not useful in 
the current environment since we disable that feature on the NOS 
s i de) . 
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3.0 PRGGRAH INTERFACE STATUS 



3 . EEQ£& Afl-llilE&EACE-SIAIUS 



The 'status 1 column Indicates whether the procedure Is 
unchanged from the previous build* modified from the previous 
build or not available In this build. Footnotes are numbered 
within each section. 



3.1 £QMAMB_EEQ££Sm£ 
E££££JlU££ 

CLP$SCAN_PARAH..LIST 

CLP$TEST_PARAHETER 

CLP$GET_K£YWQRD 

CLP$GET_SET_COUNT 

CLP$GET_VAlUEj:OUNT 

CLPSTEST.RANGE 

CLP$GET_VALUE 

CLP$CREATE_VARIABLE 

CLPSDELETE.VARIABLE 

CIP$READ_VARIA8LE 

CLP$WRITE_VARIA8LE 

CLPSSCAH.COMHAND.FILE 

CLP$£ND_SCAN_CQNMAND_FUE 

CLP$SCANi_CONHAND_LINE 

CI P$CREATE_F RECONNECT ION 

ClP$DElETE_FILE_CONNECTION 

CLPSPUSH/PQP.UTILITY 

CLP$GET_COMMAND_ORIGIN 

CLP$GET_DATA_UNE 

CLPSSCAN.PROC.OECLARATION 



SiaJUis. 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

updated to ERS Rev* 

updated to ERS Rev. 

updated to ERS Rev. 

updated to ERS Rev. 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 



3.2 a£S2LA££-££&£RAIQE 
E££££dUL£ 

QSPSFORMAT.MESSAGE 
0SP$SET_STATUS_A8N0RNAL 
QSP$APPEND_STATUS_PARAHETER 
OSPSAPPENO.STATUS. INTEGER 



unchanged 
unchanged 
unchanged 
unchanged 
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3.3 &£S£iyRa£-MMA£E!l£?ai 

RHPSREQUEST.NASS.STORAGE unchanged 

RHPSREQUEST.TERIIINAL unchanged 

AH terminal attributes can be specified on the 
RHPSREQUEST. TERMINAL call but only the following are operational* 

o auto. Input 

o tr ansparent.mode 

o prosipt.fi le 

o prompt. str i ng 

Files assigned to a terminal device can be accessed via the 
following BAM requests? 

o AMPSOPEM 

o AMPSGET.NEXT 

o AMPSGET. DIRECT 

o AMPSGET.PARTIAL 

o ANPSPUT.NEXT 

o AHPSPUT. DIRECT 

o AHPSPUT.PARTIAL 

o AMPSCLOSE 

o ANPSREWIND 

o AHPSSKIP 

o AMPSSEEK.DIRECT 

3.4 £aflfiRAfl_£JSECUIIOH 

£££££du£fi Stains 

PHPSEXIT unchanged 

PMPSEXECUTE unchanged 

PNPSTERMINATE unchanged 

PHP$AI*AIT.TASK. TERMINATION unchanged 

PHPSM ODULE.TA81.E. ADDRESS unchanged 

PHP$ENTRY.POINT.TA8L£.ADDRESS unchanged 

PHPSPUSH. TASK. DE8UG. MODE unchanged 

PMPSSET.TASK.DEBUG.HODE unchanged 

PHPSTASK.DE8UG.MQDE.QN unchanged 

PHPSSET.DEBUG.RING unchanged 

PHPSDE8UG.RING unchanged 

PMPSCHANGE.DE8UG.LI8RARY.LI5T unchanged 

PH PSPOP.TASK.DE 8UG.MODE unchanged 
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3*0 PROGRAM INTERFACE STATUS 
3.5 PROGRAH COMMUNICATION 



3*5 E&flfiaAU-caiiauiiiCAiiQH 

£££££Jlil££ 

OSPIAWAIT.ACTmTY.COHPLETIGN 

PHPSDEFINE.OUEUE 

PHP$RENOVE_QUEUE 

PHP$CONHECT.QU€UE 

PMP$DISCONNECT.QUEUE 

PMPSSEND.TO.OUEUE 

?m>$R EC E I VE.FROM. QUEUE 

PHPSSTATUS. QUEUE 

php$s tatus.queues.de FXMED 

PHPSGET.QUEUE.UHITS 



Siaiys 



unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 



3.6 CaMaiI10M-ERQ££mti£ 

P£ac.£XJii££ 

PMPSESTABLISH.CONDITION.HANDLER 

PHPSDISESTABLISH.COND.HANDLER 

PHP$CAUSE.CONDITIQN 

PNPSCONTINUE.TO.CAUSE 

PHPSTEST.COND IT ION. HANDLER 

PNPSVAIIDATE.PREVIOUS.SAVE.AREA 

PMP$ESTABLISH.DE8UG.QFF 

OS PSSET. STATUS. FRON.CQNDITION 



Villas 

Added support of detected 

uncorrected error 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 



3.7 P£fl£aA!3LSE£¥I££$ 



££&&£dU£.£ 


Sialus 


PMP$GENER ATE. UNIQUE. NAME 


unchanged 


PHPSGET.TIHE 


unchanged 


PHPSGET.HICRGSECOND.CtOCK 


unchanged 


PHPSGET.TASK.CP.TIHE 


unchanged 


PNPSGET.DATE 


unchanged 


PHPSGET.USER.IOENTIFICATON 


unchanged 


PHPSGET.ACCOUNT. PROJECT 


unchanged 


»MP$GET_JOB.NAMES 


unchanged 


PHP$GET.JQB.ID 


unchanged 


PHPSGET.JOB.MODE 


unchanged 


PNPSGET.PROGRAM 


unchanged 


PMP$GET.TASK.ID 


unchanged 


PMPSM AN AGE.S ENS E.SW ITCHES 


unchanged 


PNPSGET.OS. VERSION 


unchanged 
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3.0 PROGRAM INTERFACE STATUS 
3.7 PROGRAM SERVICES 



PMP$G£T_PRQC£SSQR.ATTRI8UTE$ 
PMPSDEFINE.DEBUG.ENTRY 
PMP$GET_D£8UG_ENTRY 
PNPSHODIFY.DEBUG.ENTRY 
PHPSREMOVE. DEBUG. ENTRY 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



3.8 LMfiLUS 

PHPSLOG 
PMP$LQG_ASCII 



Status 

unchanged 
unchanged 



3.9 EIlE_fiAliAfi£a£ai 



E£££&ilUC.£ 


Status 


Sequent 1 a I Access 


unchanged 


By te.Addressabl e Access 


unchanged 


Record Access 


unchanged 


Segment Access 


unchanged 


V_ System Specified 


unchanged 


V.User Specified 


unchanged 


U. System Specified 


unchanged 


U.User Specified 


unchanged 


F. System Specified 


unchanged 


F.User Specified 


unchanged 


AHPSOESCRIBE.MEW.FILE 


deleted 


AMPSFILE 


unchanged 


AH PSSET.FILE. ATTRIBUTES 


unchanged 


AMPSFETCH 


unchanged 


AHPSSTORE 


unchanged 


AHPSCOPY.FILE 


unchanged 


AMP$RENAME 


unchanged 


AMP$RETURN_FILE 


new name 


AHPSOPEN 


unchanged 


AHPSCLOSE 


unchanged 


AMP$F ETCH. ACCESS. INFORM ATI ON 


unchanged 


AHPSSKIP 


unchanged 


AMPSREWIND 


*2 


AMP$yRITE.END.PARTITION 


unchanged 


AHP$GET.NEXT 


unchanged 


AMPSGET.DIRECT 


unchanged 


AMP$SET.PARTIAL 


unchanged 


AMP$PUT_NEXT 


unchanged 


AMPSPUT.DIRECT 


unchanged 


AHPSPUT.PARTIAL 


unchanged 



- *1 



- *3 
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3,0 PROGRAM INTERFACE STATUS 

3,9 FILE MANAGEMENT 



AH P$S££K_ DIRECT unchanged 

AHP$GET_SEGMENT_POINTER unchanged 

AHPSSET.SEGhENT.EOI unchanged 

AHP$SET_SEGHENT_ POSITION unchanged 

AMP$SET_LQCAL_NAHE_A8N0RHAl unchanged 

AH PSSET.F II E_INS TANCE. ABNORMAL unchanged 

ANPSACCESS.NETHOD unchanged 

AHP$F ETC H_F AP.PGINT ER unchanged 

AHP$STQRE_FAP_PGINTER unchanged 

*1 Segment access If a segment access file is written and an 
AMPSSET.SEGMENT.EOI is not issued to record the £01. EOI 
remains zero* The highest page referenced is not yet used as 
the default EOI* This particularly affects those who wish to 
make heaps permanent because EOI is always zero for a heap* 



*2 AMP$REWIND The WAIT parameter on the 
suppor ted. 



procedure call is not 



*3 AHPSPUT.PARTIAL PUT.PARTIAL with the TERH.OPTION 

AMCSTERMIMATE does aoJt act as a put_next if a preceding START 
was not issued. 



3.10 ££&& Ati£BI-EILE-aAfcWfiEttEMI 



E£S£SdU££ 


Stains 










PFPSOEFINE 


updated 


to 


ERS 


Rev* 


9 


PFPSATTACH 


updated 


to 


ERS 


Rev* 


9 


PFPSPURGE 


updated 


to 


ERS 


Rev* 


9 


PFPSCHANGE 


updated 


to 


ERS 


Rev* 


9 


PFPSPERMIT 


updated 


to 


ERS 


Rev* 


9 


PFPSDELETE. PERMIT 


updated 


to 


ERS 


Rev* 


9 


PFP$DEFINE_CATALOG 


updated 


to 


ERS 


Rev* 


9 


PFP$PURGE_CATALOG 


updated 


to 


ERS 


Rev* 


9 


PFP$PERHIT.CATA10G 


updated 


to 


ERS 


Rev* 


9 


PFPSOELETE.CATALOG.PERMIT 


updated 


to 


ERS 


Rev* 


9 



3.11 MEiSQEI-JAMASEBEMI 

HMPSAOVISE.IN 

MMP$ADVISE_OUT 

MHP$ADVISE_OUT_IN 

MMP$WRITE_NODIFIED_PAG£S 

MMP$CREATE_SEGMENT 

MMP$DELETE_SEGMENT 

MMPSSTORE.SEGMENT.AT TRIBUTES 

NHP$F£TCH_SEGHENT_ATTRIBUTES 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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3,11 MENORY HANAGEHENT 



MMP$VERIFY_ACCESS 
NNPSFREE 

HHPSLOCK. PAGES 

HMP$UNLOCK_PAGES 

nn?$ FETCH.PVA.UNMR I TTEN. 



PAGES 



unchanged 

unchanged 

number of locked pages per 

segment restricted to 32 

unchanged 



3.12 SIAmiI££-.£A£ILIIX 

SFPSESTABLISH.STATISTIC 

SFP$ENABIE_STATISTIC 

SFP$DISAeiE. STATISTIC 

SFP$DIS£STA8LISH_STATISTIC 

SFPSEHIT^STATISTIC 

SFP$EHIT_SYSTEH_STATISTIC 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



3.13 IHI£EAaiM£.£ACIiin 

IFPSTERHINAL unchanged 

IFP$FETCH_TERMINAL unchanged 

IFPSSTORE.TERHINAL unchanged 

IF P$GET_DEFLTJTERHINAL_ ATTRIBUTES unchanged 

IFP$GET_TERHINAL_ATTRIBUTES unchanged 

IFPSADVANCE new - *1 

*1 Only the option IFCSADVANCE^ALL.OUEUEO.OUTPUT is supported. 



3.14 MQU¥£_£I(L£EIIQliS 



The following summarizes the exception code ranges currently 
assigned to NOS/VE* These code ranges represent a finer 
breakdown than the one specified In the SIS for internal NOS/VE 
development purposes* However* it is important to remember that 
only the product identifiers documented in the SIS stay appear in 
error messages* 



Common Nodules 
Common Code Generator 



Exception Code 

1 - 158.999 
159*000 - 159,999 
160.000 - 169.999 

160,000 - 163,999 



9,000 - 9,999 
8,000 - 8,999 



Product 
Ident if ier 

Reserved 
SY 

AM 
BA 



Product Name 



System Core 

Basic Access Methods 

Basic Access 
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164, 


300 


- 164,999 


LN 


Local Name Mgr 


165,000 


- 165,999 


JF 


Job File Mgr 


1 6 6 , ! 


300 


- 166,999 


SR 


Conversion Services 


167, 


DOO 


- 167999 


CM 


Configuration Mgmt 


170*000 


- 


179,999 


CL 


Command Language 


180,000 


— 


189,999 


JM 


Job Management 


190,000 


- 


199,999 


Li 


Loader 


200,000 


- 


209,999 


MM 


Memory Management 


200, < 


DOO 


- 204,999 


MM 


Monitor Level 


205,< 


DOO 


- 205,999 


MM 


Task Level 


210,000 


- 


219,999 


OS 


Operating System 


210, 


000 


- 210,999 


OS 


OS 


211, < 


DOO 


- 211,999 


ni 


EXEC 


212, i 


DOO 


- 212,999 


10 


MS I/O 


213,^ 


300 


- 213,999 


10 


Tape I/O 


214, 


000 


- 214,999 


DM 


Device Management 


215, \ 


DOO 


- 215,999 


ML 


Memory Link 


216, < 


300 


- 216,999 


IF 


Interact! ve 


217, i 


DOO 


- 217,999 


TM 


TM Monitor 


218,) 


DOO 


- 218,999 


TM 


TM Task 


219,1 


DOO 


- 219,999 


JS 


Job Swappers 


220,000 


mm 


229,999 


PF 


Permanent File 
Management 


221, \ 


DOO 


- 221,999 


ST 


Set Management 


222, < 


DOO 


- 222,999 


PU 


Permanent File Utilities 


230,000 


- 


239,999 


PM 


Program Management 


240,000 


— 


249,999 


RM 


Resource Management 


250,000 


- 


259,999 


OF 


Operator Faci 1 1 ty 


260,000 


- 


269,999 


AV 


User Administrator 


270,000 


- 


279,999 


IC 


Interstate Communication 


280,000 


- 


289,999 


RH 


Remote Host Facility 


290,000 


• 


299,999 


OC 


Object Code Uti 1 ities 


300,000 


- 


309,999 


DB 


Deads tart /Recovery 


310,000 


- 


319,999 


MS 


Maintenance Services 


320,000 


- 


329,999 


Reserved 




340,000 


-' 


349,999 


SF 


Statistics Fac« 


330,000 


- 


339,999 


US 


User Errors 


500,000 


- 


509,999 


AA 


Advanced Access Method 


510,000 


— 


519,999 


AG 


ALGOL 


520,000 


- 


529,999 


AL 


Assembly Language 


530,000 


- 


539,999 


AP 


APL 


540,000 


- 


549,999 


8A 


BASIC 


550,000 


- 


559,999 


CA 


Conversion Aids System 


560,000 


- 


569,999 


CB 


COBOL 


570,000 


- 


579,999 


CY 


CYBIL 


580,000 


- 


589,999 


FT 


FORTRAN 


590,000 


- 


599,999 


PA 


PASCAL <Wirth) 


600,000 


- 


609,999 


PI 


PL/1 


610,000 


- 


619,999 


SM 


Sort Merge 
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620,000 - 629*999 
640,000 - 649f999 



sc 

08 



Source Code Uti I i ty 
Debug 
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4 . QUAL-£I&I£-a£4Q$I4&I-M2-0E£SAIIflB 



4 . 1 CyER£&I-DyAL-SIAI£-£aiEI£U&AII£m 

The Arden Hills S2 development systems are configured to run 
with three FMD units* 

o FHO Unit 43 

This unit contains the following? 

- A170 MPS (5*3 as released)* CTI# n$l, EI binaries. HQS 
deadstart f i I es 

Files associated with user name LIBRARY 
Files associated with user nape SES 

- files associated with DEVI* DEV2t REL1» INT1* 

o FND Unit 41 

This unit contains the following* 

Files required to deadstart dual state Cycle 3| A170 NQS 
(5.3 plus changes necessary for Cycle 3)» CTI* HSL* EI 
binaries* and NQS Deadstart files* 

- It is also used as a temp device* 

o FMD Unit 42 

This unit contains the following: 

- NOS/VE Development Area PL's and Hember PL's 

- NOS/VE Deadstart Files to be tested Csaved in individual 
user's catalogs) 

Files associated with user name INT2 

o FHD Unit 44 

This is another NQS PF device* 
o FHD Unit 45 

This is another NOS temp device* 
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4 * 2 US£R_ilAflES_AlUi_E£EaAi.£ti;L.£IL£S 

1) The convention ysed for creating user names on NOS/VE is as 
foi lows J 

o Your user name Hill be your initials* 

o Your password will be these 3 letters followed by the 

letter • x • * 
o You must see CONSOURCE (R*K* Cooper - x3092) to be 

assigned a user index 

2) P? dumping and loading 

You may use **SES*DUMPPF** on SN/101 to dump your permanent 
files to tape* and then load them onto your user name on A170 
NOS using w SES.LOADPF w . Documentation on how to use these SES 
procedures and what their parameters are is included in the 
SES User's Guide* or they can fee obtained by typings 

$ES*HELP*DUMPPF and SES.HELP*LQADPF . 

* . 3 Ifl-R£LaAD-CD!IIRflLMA&£-£fl&.ia£-llflSZM£-DISIi.ttRI5t£E 

At deadstart time NOS Mill automatically load 7155-lx disk 
controlware on one channel with controller type=FM CL8C CMRdeck 
entry)* and will automatically load 7155-4x disk controlware on 
any channel with controller type*HT (L8C CHRdeck entry)* NOS/VE 
supports both of those types of controllers* NOTES It is not 
possible to use 844 half-track controlware in this environment* 

4.4 Alza.BQ£-D£ADSIARI 



4,4.1 CTI AND CHECKING CENTRAL MEMORY 



Deadstartlng A170 NOS assumes some knowledge of CTI* CTI 
stands for Common Test and Initialization* It is software that 
places an 800 series machine in a state such that it is possible 
to deadstart an operating system* CTI is used somewhat 
ambiguously in the software community to imply CTI and MSL 
(Maintenance Software Library)* The MSL is a collection of 
programs and data that includes such things as a subset of CMSE 
(Cyber Maintenance Software Executive) that enables one to load 
controlware to controllers* look at CY8ER 180 maintenance 
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registers* took at microcode* etc. The MSL also contains 
microcode that can be loaded by CTI. The HSl is actually an 
©aerating system that runs independently of NQS. An important 
element of CTI/HSL is HIVS (Hardware Verification Sequence}* 
which is a program that loads microcode* clears and checks 
central memory and tests ail 170 opcodes. If you are not sure 
what the machine was used for (particularly the first hands on 
user each morning) then the HIVS program should be run. This is 
accomp 1 ished by s 

1) deadstart to NOS/VE (unit 40 for S3, unit 41 for S2) 

2) Enter (operator intervention) 

3) Enter P (deadstart panel*make sure level deadstart) 

4) <8KSP> 

5) Enter H (assure yourself that CS*YES to reload microcode) 

6) <SKSP> 

7) Enter V (verification sequence) 

8) Hit <CR> at 'parameter display* to test CH & CP 

When you see text that tells you that verification is complete 
and a deadstart is required* you are now ready to deadstart NQS. 

4.4.2 NQS DEADSTART 



See Section 3.3 of the Integration Procedures Notebook for 
Important NQS CMRDECK changes, 
o Set the D/S panel to deadstart from the primary system disk. 

This is Unit 41 for all Cycle 2 systems* 
o Push D/S button 
o Enter (CR) 
o Enter date/time 

Malt for deadstart to complete. 

Note: The deadstart tape DUAL34 (which is currently installed on 
unit 41) is found in the area in the northeast corner of the S2 
lab where the tape cabinet is found. 
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4*4,3 INITIALIZING AN 855 <S3) 



If an 855 is powered down {processor! It may be impossible to 
deadstart or even run the HIVS program. The reason is that 
powering up does not master clear the maintenance channel* This 
is a known problem and is being addressed by COED* The way to 
solve this problem currently Is to used the CNSE equivalent of 
the HIVS program* That program can be executed by perforating an 
alternate deadstart to the engi neer * s/CE f s CMSE pack* entering n 
(to select maintenance)* entering a CR at the menu screen* and 
then entering «GQ INIT39*. INIT39 is a CNSE command buffer and 
will require about 2 to 3 minutes to complete* yhen the display 
shows a •TB* (terminate buffer) the initialization is complete* 
The 39 stands for a microcode cycle* i*e* the 855 is currently 
using cycle 39 microcode* 



4.5 Mfl*ujiE-aEAam&i-Aafl-iasnLuiiQB 

o Enter D0WN*CH2. so NOS/VE can use the channel. 

o Enter DOyN*CH32. so NOS/VE can use the channel. 

o The following file must be available in your catalog on the 
S2J 

TPXXXK contains a NOS/VE deadstart image* This must be a copy of 
the dual state deadstart images available from the link 
procedures. 

o If you've never deadstarted NOS/VE from the user number from 
which you want to run or if you wish to change the current 
parameter settings for your particular user number* then do a 
SETVE. SETVE assumes the file TPXXXK is in your user number; 
you do not have to do another SETVE if TPXXXK has changed 
since the last time you ran* The general form of SETVE is* 

X.SETVE(PN*ffff*UN*un.C=6) 

where ffff is an identifier of up to 4 characters and un is 
the user number to search first for files* 6 is the number of 
the system core command deck for the Arden Hills 
configuration. In general ffff and un will be the same* e*g* 
X. SETVE (DAH.UN=DAH*C*6) 

♦♦Only ONE SETVE should be done for each user number and a 
SETVE should NOT be done for ANY Integration user number 
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4.0 DUAL STATE DEADSTART AND OPERATION 
4.5 NOS/VE OEADSTART AND INSTALLATION 



except by the Integration project.** 

SEE SECTION 5.1 FOR HORE DETAILS. 

o Bring up dual states 

N.NVEf fff . 

where n Is any control point number except 1*2 and the 
BATCHIOt MAGNET £ SYSTEM control points and ffff is the 
identifier specified in SETVE, e.g. 4.NVEINT1. 

o Bring up the Operator Facility 

Enter k»n - where n is the control point of the NVE job. 

NOS/VE is currently generated and initialized on both NOS 
and NOS/VE* All source and object libraries that make up the 
NOS/VE system are produced on NOS and therefore must be 
converted from their CI to II counterparts. Other parts of 
installing and initializing the system (e.g. building the 
$SYSTEM catalog) are performed by command language procedures 
on NOS/VE* Since the same system will many times in a closed 
shop environment* it is advantageous to only perform the 
conversion from CI to II a single tlmej save the results in 
the NOS file system and then simply bring the files back 
during deadstart. 

The actual files that get installed and loaded on each 
deadstart are determined by a command language procedure (the 
system profile) interpreted on NOS/VE. This procedure can be 
modified by each site to initialize their NOS/VE environment 
in the most suitable fashion. The process of building the 
system profile and of performing the CI to II conversions is 
referred to as an installation deadstart and the process of 
executing the system profile and of fetching previously 
converted files from NOS and making them available in the 
NOS/VE file system is referred to as a deadstart. A single 
command is available to perform both an installation deadstart 
and a deadstart. 

4.5.1 THE DS PROCEDURE 

The purpose of this command is to perform an installation* 
normal or recovery deadstart of NOS/VE. The defaults for 
parameters are those most convenient for "closed shop" 
deads tar ts. 
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4.0 DUAL STATE DEADSTART AND OPERATION 
£« 5 »1 W THEDS PROCEDURE ^^^ 

The procedure "brings. up" the job log display on the left 
screen where the progress of the procedure may be watched* and 
the control point display on the right screen* Just before 
the procedure changes the left screen to display the system 
log and writes to that log the messages 

i Deads tart Completed — - — * 

at which point the operator way enter commands* 

ds [kind-install * normal \ recover! 
Cget_source_l i brar I es*<boo I ean>3 
Cget_products*<boo lean>3 
techo*<boo I ean>3 

Cal ternate_user a! <NQ$_user,.name>3 
Csave^i nstall.f i I es»<boo lean>3 
Cval I date_users»<bool ean>3 
[qu ick_val idate-l 1st of <name>3 
tdebug*<boolean>3 
[help*<file reference>3 
tstatus-Cstatus yariable>3 

kind * k* This parameter specifies what kind of deadstart is 
to be performed* Valid specifications are? 

install • i - installation deadstart to be performed* 
The system libraries are built from CI object 
f i les* 

normal \ n - norma! deadstart to be performed* The 
system libraries are obtained from the results of a 
previous installation deadstart* 

recover I r - recovery deadstart. Just initiates system 
tasks* Permanent files are "recovered" from a 
previous run of the system* 

Omission will cause a recovery deadstart to be 
performed. 

gat_sour ce_l i br ar i es J gsl* This parameter specifies whether 
SCU libraries are to be installed* Valid specifications 

are J 

true \ yes * on - libraries are to be installed 
false 5 no \ off ~ libraries are not to be installed 
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On the Arden Hills closed shop S2 system* the SCU 
libraries to be installed are* 

aSFPIt -> 0$F$PROGRA«_INTERFACE.LIBRARY» operating system 
program interface 

OSFSL -> OSFSSQURCEJLIBRARY* subset of operating system 
source library 

Omission will cause SCU libraries to be installed* 

get.products * gp: This parameter specifies whether the object 
libraries defining the current product set are to be 
Installed* Valid specifications ares 

true I yes » on - the products are to be installed 

false * no * off - the products are not to be installed 

On the Arden Hills closed shop S2 system* the product 
set to be installed consists of: 

CYFIIC -> CYFSCOMPILER: cybiJ II compiler 

CCFRTL -> CCF$RUN_TIME_LIBRARY: common compiler modules 
run time I Ibr ary 

NLFRTL -> HtFSRUH.TIHE.LIBRARYs math run time library 

DBFDL -> DBF$0E8U6.LIBRARY5 symbolic debug library 

SCFOL -> SCF$OBJECT_LIBRARY* source code utility 

SCFCL -> SCF$CQHHAND_LI8RARY» source code utility 
"stand-alone" command library 

IFFEDIT -> IFFSEDIT0R2 Jack Bohnhoff»s editor (JEOIT) 

Omission will cause the product set to be installed* 

echo \ e: This parameter specifies whether the commands should 
be echoed to the console during execution* Valid 
specifications are: 

true J yes J on - echo commands 

false ' no S off - do not echo commands 

Omission will cause commands not to be echoed* 
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al ternate.user * au; This parameter specifies what HOS user to 
check if the default NVE user does not have the needed 
file* Any NOS user name is a Mowed, 

Omission will cause INT1 to be used* 

save. i nsta ll_f i I es * sifs This parameter specifies whether to 
save the system libraries created by an installation 
deadstart* This parameter is ignored for a normal or 
recovery deadstart* Valid specifications ares 

true I yes \ on - save the installed system libraries 

false ' no * off - do not save the installed systen 
I i brar i es 

Omission will cause the files not to be saved. 

val Idate.users \ vu: This parameter specifies whether to run 
the job that validates NOS/VE users* This parameter is 
ignored for a recovery deadstart* Valid specifications 

ares 

true * yes * on - run the validation job 

false * no 1 off - do not run the validation job 

Omission will cause the validation job to be run* 

qui ck_val i date J qvs This parameter determines which users 

will be validated by the validation job if it is run. 

When specified* this parameter gives a list of user names 

to be validated in addition to the users: INT1* INT2« 
DEVI* DEV2* REL1, EVAL and RKC. 

Omission will cause all users to be validated* 

debug * d: This parameter specifies whether the procedure 
should abort if an error condition is detected* Valid 
specifications ares 

true * yes * on - do not abort on an error* The user 
will fee prompted for commands in the event of an 
error at which time entering "continue" will cause 
processing to resume. 

false * no « off - abort on an error 

Omission will cause the procedure to abort when an 
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error is encountered. 

help » hs This parameter specifies whether help information is 
to be written. If this parameter is specified* the help 
information nil) be written to the specified file and the 
procedure win terminate. 

Omission wi I ) cause the procedure to execute and the 
help information not to be written. 

status? See ERROR HANDLING in the NOS/VE ERS. 



If you change any of the following decks you MUST use the 
installation deadstart from your own catalog <with flies 
CYBILGO. XUOCH, XUOSU XULIB and XLJEO* or you must use 
the alternate.user parameter to specify a NOS catalog 
containing the files (e.g. DEVI). 

AVHUTIL CLMDP DMMDISA ICMCtOS ICMFAI ICMFAPC ICHFLSH ICMGET 

ICMOPEN ICMPUT ICMWEOP IFMEXEC IIMA72H IIMDC2S IIMRLE 
IIMRSE IIMRUH IIMRUSM IIMTDEL OCMADD 0CM8IM GCM8IM OCMCQL 

QCMCOM OCMCPY OCMCRM OCMDEF OCMDEL GCMDLB QCMONL 
GCMDQL OCMENB OCHGEN OCMLCH GCMLMG QCMLP OCMMUR 
OCMNP OCMOBJ OCMOFH QCMOHS GCMRCH QCMRED OCMREP OCHRMB 

OCMSAT QCMSOL OCMVEL QCMVLU GCNVOL PFMDC PFMTALL 
PUMBCAT PUMBCYC PUMBfIL PUMBFG PUMBLST PUMBPF PUMBSET 
PUMCOMN PUHCRAK PUMPURG PUHCRAK PUMIOBF PUMLIST PUHHISC 
PUMPURG PUMRALL PUMRCAT PUMREC PUMREF PUMRFIL PUHRPF 
PUMSTUB RHMLML RHMQAT RHMQGP RHMQRE RHMSFM USORT UTMOUR 

UTHPC1 UTMPC2 UTMPC3 UTMPC4 UTMPC5 UTMTSA UUSER1 



4.5.2 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 

Type 

K#n. where n is the NVE control point number. 

K.SETLA (your_un*NVE ) your.password 

K.GETF DS Unseat 

K.OS INSTALL GSL-NO GP*N0 AU*scat 

4.5.3 EXAMPLE OF NOS/VE "NORMAL" DEADSTART 

The Integration system has had the installation deadstart 
run on it. Also the files produced by the installation 
deadstart have been made semi-private and are found on the 
catalog used in the NVExxxx call* 
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Type Iwhere DEVI is the sa*»e as the xxxx in the NVExxxx 
cal I): 

K*n* where n is the NVE control point number. 

K.SETLA <D£V1>NVE> DEV1X 
K.GETF DS 
K.OS NORMAL 



4.5.4 EXAMPLE OF NOS/VE RECOVERY DEAOSTART 

This Is the kind of deadstart that should post frequently 
be done in a "closed shop** environment and consequently is the 
one for which all the parameter defaults are oriented. It 
presupposes that permanent file recovery has been successful. 

Type (where DEVI is the same as the xxxx in the NVExxxx 
call ) : 

K*n. where n Is the NVE control point number. 
K.SETLA <DEV1*NVE) DEV1X 
K.GETF OS 
K.OS 



4.5.5 EXAMPLE OF MINIMAL NOS/VE OEADSTART 

The minimal deadstart shown below may be useful to OS 
developers who need to get the system up quickly and do not 
need the product set or all validated users. 

Type 

K>n* where n is the NVE control point number. 

K.SETLA Cyour.un.NVE ) your_passwor d 

K.GETF OS Unseat 

K.OS NORMAL GSL*N0 GP*N0 QV*your_un AU*scat 

4.5.6 USE OF THE QUICK. DEAOSTART COMMAND 

This command is intended as a development tool to 
facilitate •fast* deadstarts where recovery is not needed; 

Indeed* if this command is entered £££flX££X Mili~&££_&£ 

2&£X&LI££l when the system Is brought down for whatever 
reason. Specifying this command will cause an installation 
deadstart to take place* If the INXTDD command is not 
specified then a default value of f VSN001* is used for the 
system deadstart device. Use of INITDO will allow setting the 
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4.5.6^U$£ OF THE QUICK. OEADSTART COMMAND 

deadstart devices identifier to any value* THIS COMMAND WILL 
HOT 8E ACCEPTED FROM A DEADSTART COMMAND FILE, 

Formats QUICKDS or QUICK_DEADSTART 

Values: The default is false. Executing this command 
causes this initial value to be toggled* thus executing! this 
command twice nil! cause the final value to be false* 

Motes QUICK_TEMPLATE_LOAD does not exist now* 

4 . & mmJLHI££ACmE_£ACILIII-QRE&AIIQli 



4.6.1 OPERATOR INITIATION 

To bring up the NOS/VE interactive facility do the 
f ol low i ngs 

1) Bring up NOS/VE. 

2) Bring up NAM 

At the system console enters 

3.NAMS2. for S2 
3.NAMS3. for S3 

3) If IAF is not up at control point 1* enters 
IAF. 

4.6.2 OPERATOR TERMINATION 

To terminate NOS/VE interactive any of the following may be 
dones 

- 3.CFQ.DI*AP-TAF. 13 Is the NAM control point number) 

This is the preferred method. To bring NOS/VE interactive 
back up* you must first do a 3.CFO.EN* AP»TAF . 

3.CF0.DI»NE. (3 is the NAM control point number) 

This terminates the entire network including IAF#RBF» etc. 
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4.6.3 OTHER OPERATOR CAPABILITIES 



- To logically turn the printer on* under DSD enter! 

0N33. 
F0RH33*TH. 

To send a "shutdown warning** to all terminals logged on to 
TAF do J 

3.CF0.ID* AP=TAF. C3 Is the HAH control point number) 

To send a message to all terminals do* 

3.CFG.HSG#ALL»message* <3 is the NAN control point 
number ) 

PASSON has the ability to record various types of 
diagnostic information. This capability is controlled via 
the sense switches at the PASSON control point. To turn a 
sense switch on Coffl at control point N dos 

N.ONSWX. <N.0FFSWX.} 

Where X is the desired sense switch CI to 6). The PASSON 
default is all sense switches off. It will take a short 
period of time before PASSON detects a change in a sense 
switch and reacts to it. The sense switches currently used 
by PASSON ares 

£HJ.££u_i uSfi 

1 Network Trace 

2 PASSON Logic Trace To Dayfile 

3 Memory Link Trace To Dayfile 



4 * 7 aQSZ^E.fl££lUIQB-£At ILIII-Allli-Q££R AIQU-MMttAHQS 



With the release of the Operator Facility Phase 1 several 
changes to the NOS/VE Operating System will occur that will 
effect the users of the NOS/VE Operators Console. The 
Operator Facility runs as part of the NVE control point. When 
the request for K display appears on the NOS B Display* assign 
the K Display to the NVE control point. The Operator Facility 
is capable of displaying both a left and a right screen area 
at the same time. If the operator wants both screens, then 
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4.0 DUAL STATE DEADSTART AND OPERATION 

4,7 NOS/VE OPERATOR FACILITY AND OPERATOR COMMANDS 



type in KK* 

the commands 



The contents of these displays are determined by 
entered by the operator. 



The left screen is divided into four different areas* The 
top most area is the system header which contains the current 
date and time* memory statistics* and an operator action 
message if one is posted* The operator action will include 
the job sequence number of the owner of the message and 
•message cancelled* if the message is cancelled because the 
task has terminated. The next line contains the first 64 
characters of the operator action message <60 characters in 
stand alone)* 

The next area of the screen is the main output area* This 
area has the file name of OUTPUT* Any display command can 
have its output directed to this area as well ^s any system 
command* 



The third area is towards the bottom of the screen* This 
area is two lines long and contains the response area* This 
will contain error messages from system commands* The area is 
cleared when the next operator typeln is entered at the 
operator's console and received by NOS/VE. 



The fourth area is the prompt area* This will contain the 
status of the keyboard* If NOS/VE is processing a command* 
then the keyboard Is locked and all typeins will be ignored* 
When the keyboard is locked* the message 'data received by 180 

keyboard locked 1 will appear at the screen^s bottom* When 
the keyboard is unlocked then any data In the keyboard buffer 
will be sent to NOS/VE* The bottom line Is the last line that 
was processed by Operator Facility* 



The right K Display has the file name OUTPUT_RIGHT* There 
Is only one area on the right screen therefore the main 
display area is 10 lines longer than the left screen area* If 
a dayfile display or CP display is shown on the right screen 
you will get more lines of Information than on the left 
screen • 



There are no default displays that come up automatically on 
either output display area* It is up to the operator to 
decide the display the operator wishes to see* The only parts 
of the display that come up automatically Is the system header 
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display and the prompt area for keyboard status* 



The page width of the screen is 60 characters for 

standalone and 64 characters for dual state* The character 

set translation code is the same as that for the current NVE 

Subsystem control point* The escape code sequence for the 
special characters to be typed has not changed* There are a 

few differences in the processing of data by the Operator 
Facility and NVE Subsystem* 

1) Do NOT end commands with a period. Periods are sent to 
NOS/VE. 

2) The NVE subsystem commands that begin with an asterisk will 
not be supported from the Operator Facility control point* 
If these commands are entered from the Operator facility 
they will be passed on to SCI where an illegal command will 
be issued. 

3) Routing of console job data to a specific job by the 
•n-command' protocol will not be supported In dual state* 
This feature should work in standalone but will not be 
supported. 

4) No type ahead - commands cannot be entered until the prompt 
area shows that they are requested* 



There is one new command to replace the current display 
commands* The entry points for Zdis* Zdisb* and Sdis have 
been deleted. The new command is VEDISPLAY and has two 
parameters* The options are listed below. The values in 
paranthesis are the abbreviations. Note that this command 
does not begin with an asterisk (*)* This command will be 
processed by SCL and create a new system control point task to 
display it»s data. The user can have the same display type on 
each of the display areas* if the user so desires* 



Command Name Display Type Screen Area 



Parameter Name Parameter Name 

DISPLAY. OPTIONS OUTPUT (0) 
DISPLAY.QPTION (DO) 
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Parameter Values Parameter Values 

VEDISPLAY IVED) 0ISPLAY.SYSTEM.LOG OUTPUT 

JOB.LOG <Jl) OUTPUT.RIGHT <0R1 

CONTROL. POINT CCP) 

The default file naie for all displays is OUTPUT. 

The following Is a brief list of commands to bring up NOSVE 
with the Operator Facility installed* 



n.NVEffff. to bring up NOS/VE* (See Section 5) 

K#n. n - control point for NVE* 

KK* to bring up the K display on both screens* 

K*VED JL to bring up the job log* 

or 

K.VED DISPLAY.OPTIONS^JL GUTPUT«OUTPUT 

to bring up the job log using key word 

i denti f iers* 

K.VED CP OUTPUT.RIGHT 

to bring up the control point display on 

the right screen* 
or 
K.VEO DI$PLAY.0PTIQNS=CONTROL.POINT OUTPUT*OUTPUT.RIGHT 

to bring up the control point display using 

key word 

identlf i ersm 

K.xxx send any command to 'NOS/VE* 



K. TERMINATE. SYSTEM. JOB to terminate NOS/VE. 

Note! After the OS procedure has completed execution the 
command to enter to bring down the system is 
TERMINATE. SYSTEM. JOB* not TERMINATE. SYSTEM. 
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4,7a DELETE.jQB.QUEUE \ DELETE. JOB_QU£UES I DELJQ (NEW) 

The purpose of this coimand is to delete all files from the 
job input subcatalog* the print suhcatalog or both* This 
command is only allowed from jobs with operator and or system 
pr I vi I eges* 

de I ete.job. queue [queue_name* i nput 'output* al I 3 

£status«<status variable>3 

queue_name * qr\t This parameter specifies from which 
subcatalogs files are to be deleted. Specifying 
INPUT will cause all files to be deleted from the 
job swap suhcatalog and the job input subcatalog* 
Specifying OUTPUT will cause all files to be deleted 
from the job output subcatalog* Omission will cause 
all to be used* 

status: See ERROR HANDLING* 

4.7*2 REBUILD_INPUT_OU£UE \ REBIO (MEW) 

The purpose of this command is to rebuild an entry In the 
Known Job List (KJL) from information in the System Label of 
the file representing the job being processed* This command 
is to be used during the process of recovering the input 
queues during recovery deadstart* 

rebui I d_input_queue Iname*<name>] 

t status-<status variable>3 

name J n: This parameter specifies the file name of the 
file representing the job* An attempt is made to 
process the specified file within the catalog where 
job input queues are known to reside* 

status* See ERROR HANDLING* 

4.7.3 RE8UILD.0UTPUT.QUEUE J REBOQ (NEW) 

The purpose of this command is to rebuild an entry in the 
Known Output List (KOL) from information retained in the 
System Label of the file representing the output being 
processed* This command is to be used during the process of 
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recovering the output queues during a recovery deadstart* 

refoui I d„.output_queue Cname-<name>1 

£status*<status varlable>3 

napes This parameter specifies the file name of the file 
representing the output* An attempt is made to 
process the specified file within the catalog path 
of where job output queues ^re known to reside* 

status: See ERROR HANDLING. 

«. 8 aayi£-iM»iiaEyi>EiL£.£aaH-£i2a.iQ-£isa 

Through the system console* enter : 

Type 

X.DIS* 

USER.A.B. 

GET* f i lename* 

where filename Identifies the input file to be routed* 

ROUTE* f i lename«DC»LP*FC*RH. 

4.9 IL-DISELAX-ASCII 

Support of 6-12 ASCII from the console (K display) causes 
the following changes: 

HJEUI I&AHSkAIED-IQ IHEUI I&AttfkAIE&-IQ 

/I 

fZ n 

/3 # 

M $ 

/ 5 (reversed / ) 

/6 I 

II ? 

/8 € 

/9 > 

/0 _ (underscore) 



/( 






C 




/) 






1 




/+ 






> 




/- 






< 




/» 






* 




/* 






t 


(single quote) 


// 






/ 




/. 






• 
• 




/A 


to 


/Z 


a 


- z (lower cas 
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4.10 aSai-MEQSMIIQM 

To create an Express Deadstart Dump (EDO) tapes 

1) Mount scratch tape (ring in) on a 9-track drive. 

2) Push D/S button. 

3) Select U (utilities) display. 

4) Select £ (EDO) display. 

5) Set channel (S2*13). 

6) Set ECUU (S2=01uu) 

E * equipment 

C * 1 for 67X dr i ves 
2 for 66X drives 

uu * unit number of the tape drive to be used. 

7) Answer "dump number** with a CR. 

8) Answer M non 2ero inhibits rewind** with a CR* 

9) Answer "channel control ware" with a CR* 

* - Warning if this step is omitted* DSDI canot 
process the dump tape. 

To create a listing of the EDO tapes 

1) REQUE$T>OUHP.NT,D=PE>F«S*lB«KU#PQ*R.VSN*your choice. 

2) G£T»DSDI/UN*DEV1. (On S/N 101.) 

or 
GET»DSDI/UN=DEV1. (On S2.) 

3) Create DSDI directives files 

A DSDI directive file should include the following* 

IOUHR. 

PROMR. 
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4*10 DSOI INFORMATION 



MEHMR. 

PRQRF. 

y* f I rst„byte_address* 1 as t_byte_adress» asi d. {where 

the f irst_byte_address and I ast_byte„address are hex 

byte addresses and asid is the asid of the segment to 

be dumped) 

4> Execute DSDIs 

RFL.-60000. 

0SDI#M*0>I* w input directives file". 

5) To run < after the first time)* 
OSDI»I*n. 

(Does not read tape again*) 

6) To run interactively: 

Same as above* except to do y command must first do* 
OUTPUT, LISTFIl* 

7) C170 DSOI information can be found in Chapter 10 of 
the NOS SYSTEM MAINTENANCE Manual* 

A170 OSDI info can be found in document ARH3060 — €10 
for A170 N0S/S2. 

4*11 afliU¥£_I£R!iIaaIIJ3a 

o Bringing down dual state: 

K*n - n is the NVEffff control point 

K. TERMINATED YSTEM_JaB 
o If not a normal termination 

K«n - n is the NVEffff control point 

K.*RUN. 

K**ENDLST. 

K.*ENDRUN* 
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4.12 A170 NOS SHUTDOWN 

Before leaving the machine* it is necessary to bring NOS 
down* If NOS has crashed* a level 3 deadstart wust be 
attempted even if the only reason Is to bring NOS down. To do 
a I eve I 3 deadstart J 

1) Push 0/S button 

2) Select w O w display 

3) Select M P M displ ay 

4) Enter 1*3 

5) Enter (CR> 

6) Enter date/time 

If a dump is desired but a crash has not occurred STEP, 
should always be entered before pushing the deadstart button. 
After the dump has been taken a level 3 deadstart should be 
per formed. 

To bring NOS down* do the following: 

1 ) Enter: 

CHE 

The screen will display: 

CHECKPOINT SYSTEM. 
Enter: carriage return 

21 Hake sure no mass storage device has a checkpoint 
rquested. To do this* enter: E*M. If the display shews 
there are no M C w s in the status field* then all devices 
are checkpolnted and you may continue. 

3) Enter: 
STEP. 

4) Push deadstart button. 
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5 * a££QJdEaX.flf-HQiZSi£-££&!iAa£MI-£IL£fi 



5.1 ££I¥£_£QEMjU: 



The general format of the SETVE command is 

X.SETVE{PN«ffff#UN*un>VSN*vsn.D»d.P»p.B«b.C*c»CH»ch) 

ffff Is a string of no more than four characters. SETVE 
appends ffff to *NVE* to construct the name of a 
procedure file which* when invoked* will deadstart 
NOS/VE. The default is TST. 

un specifies the user number from which TPXXXK is 
attached* Un is the first catalog searched for 
other files used in deadstarting and terminating 
NOS/VE. The default is INT1. 

c specifies the deadstart command deck to be used when 
deadstarting NOS/VE* The function served by the 
deadstart command deck is analogous to the function 
served by the CHRDECK of NGS. Currently supported 
values for c and their respective uses are* 

1 Arden Hills S3 S/N 02 open shop/hands-on time 

3 Arden Hills S3 S/N 02 closed shop 

6 Arden Hills S2 S/N 104 open shop/hands-on time 

10 Sunnyvale S2 closed shop installation 

40 Sunnyvale S2 closed shop continuation 

The default is set in the file CMDS1. Currently 
the default is 6. 

b specifies an alternate catalog to be searched for 
the various files used in deadstarting and 
terminating HOS/VE. The default is INT1. 

d is used to indicate that the system core command 
processor should accept commands from the console* 
Specifying 0-T in the SETVE command allows the 
operator to enter commands from the console after 
processing the deadstart command deck* If the 
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operator wishes to Initialize the system device 
and/or install a new version of NOS/VE* 0*T must be 
specified. The default is set in the fife CHDS1. 
Currently the default is D«F. 

P specifies the password for the catalog indicated by 
the un parameter. If this parameter is omitted the 
password will be generated by appending an *X f to 
the UN parameter. 

ch specifies the octal channel to be used for NOS/VE 
disk I/O. The default is set in the file CHDS1* 
Currently the default Is 2. 

vsn specifies the ^sn of a deadstart tape* If this 

parameter is used then NOS/VE will be deadstarted 

from the tape specified. If it is omitted* then 

NOS/VE will be deadstarted from the permanent file 
TPXXXK. 



5.2 S£Iii£_U.Ufi£ 

Earlier versions of NOS/VE required that two SETVE cowhands 
be issued if the system was to be installed and subsequently 
recovered. The current system does not require this. The 
oniy reason for issuing two SETVE commands is to provide a 
deadstart procedure that does not require/permit operator 
inter vent i on. 

It should be noted that once the SETVE command has been 
issued* it need not be issued again unless*. • 

1) There is a need to change one or more of the parameters 
specified in SETVE. 

2) The command file* NVEffff* generated by the SETVE 
command is purged from the system* 

Two examples of SETVE usage and subsequent NOS/VE deadstart 
are given below. The first example shows a "hands on** user 
working with recovery. The second illustrates these concepts 
for a typical NOS/VE closed shop. This writer hopes that the 
reader will find both examples useful and illuminating. 

I. A "hands on n user 

The command file NVERSD Is built and installed in NOS 
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by typing 

X.5£TVECRSD#UN«R$D»V$N«TAPE.B«DEV1#C*6,D*T) 

Several of the choices of parameters are worth 
not! ng. 

1) By specifying the VSN parameter the user has built 
a command file that will deadstart the system 
directly from the tape produced by NVESYS* 

2) The user in this example has specified deadstart 
command deck 6 (C parameter) and has allowed the 
NQS/VE disk I/O channel Cch parameter) to default 
to 2. One concludes that the user is running on 
the Arden Hi I Is S2* 

3) The user has specified D-T« This is important* 
The deadstart command which triggers installation 
of a recoverable system cannot be read from a 
deadstart command deck* It must be entered from 
the console at deadstart time. Specifying s T 
allows the operator to enter commands from the 
console* 

NOS/VE is deadstarted by typing 

n.NVERSD. 

at the console. (n is a control point which is NOT 1* 2 
or ordinarily occupied by MAGNET. BATCHIO, or SYSTEN) 

The user brings up the K display by typing 

K * n« 

(where n is the NVE control point.) 

Presently, the deadstart command deck is displayed 
and the user is prompted for input. The deadstart 
command deck used in this example looks like this? 

USECP S2CFIG 

USEIP EHPTY 

SETDCT $7155.1 

SETDO $885.12 32 

The user types 
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K.INITDD VSNO01. 
K.GO. 

The system accepts the commands and installs and 
deadstarts NOS/VE. 

After the system comes down* via either controlled 
termination or a crash* the system can be recovered (if 
necessary) and redeadstar ted by typing 

n.NVERSD* {where n is an appropriate control point.) 

yhen the deadstart command deck is displayed* the 
user types 

GO. 

This Hill cause NOS/VE to be deadstarted without 
initializing the system device* 

II. A typical "closed shop" 

Two command files* NVECLSH and NVEINST* are created 
by typing 

X*SETV£CCLSH*UN*CLSH*B»0EV1,C»40*CH«1) 5 

X.$ETV£<IN$T*UN=CLSH*B*DEV1*C*10*CH*1*D«T) 

One notes that 

1) Closed shop is deadstarted from a TPXXXK file In 
the CLSH catalog* 

2) Specifying D*T» for NVEINST* causes deadstart to I 
pause for operator intervention. ! 

3) Using DCF deck 40 for continuation suppresses I 
redundant land possibly damaging) reexecution of • 
the configuration prolog* # 

A normal deadstart is used when bringing up NOS/VE at 
the beginning of closed shop or following a system 
failure* The operator* in this example* types 

n. NVECLSH. 

NOS/VE will recover flf necessary) and deadstart. No 
operator intervention is required. 
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If it is necessary to reinitialize the system device* 
or If the installation Is upgrading to a new version of 
NQS/VE* the operator keys 

n.NVEINST. 

This causes deadstart to pause and wait for operator 
input when deadstart commands are being processed. 
There are two cases requiring discussion here. The 
first is the case of upgrading to a new and compatible 
version of NOS/VE. The second case is used only when it 
is necessary to reinitialize the system device. 

The first case involves the installation of a new 
version of NOS/VE. In order to install a new version of 
the system* the old system must have been idled In an 
orderly way. A new system cannot be installed if* 
following a crash* the system being superceded was not 
recovered. Assuming everything in the old system is 
tidy* and the file systems are compatible* the operator 
keys 

K.OSECP EMPTY. 

K.SETSA INSTALL.J08.TEHPLATES 1. 

K « 6 . 

when the system displays the deadstart command deck snd 

prompts for input. The new system is installed* the 

file system is preserved* and deadstart proceeds. 

The second case amounts to an installation 
deadstart. This should be used only with full knowledge 
that any files which may have existed on mass storage 
prior to this deadstart* wj.il-&e.-feias.i£d io£fi flfcli.v.ian 

An installation deadstart will be required If 

1) This is the initial installation of a recoverable 
version of NOS/VE. 

2) If the file systems of the system being installed 
and the system being superceded are not 
compat ib I e. 

3) If the file system has been damaged beyond the 
possibility of recovery. 

An installation deadstart is effected by typing 
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K.INITDD VSN001, 

K.GO. 

when the deadstart command deck is displayed and the 
operator is prompted for input* 



NOTES 



1* The CH0S1 file used to deadstart NOS/VE must have 
the DE8UG2 flag set to TRUE. When NOS/VE Is 
deadstarted* the catalog specified by the UN 
parameter is first in the search order for CNDSlt 
followed by the catalog specified by the B 
parameter • 

2. See Section 3.3 of the Integration Procedures 
Notebook for other information about the CMDS1 
file. 

3* If NOS/VE crashes and a dump is desired (in the 
context of our second example) 

i. Type du at the HOD console. The message 

"WRITING IHAGE FILE" should appear 

immediately. The message "IMAGE FILE 

COHPLETE** should appear a few moments 
later* 

ii. Push the deadstart button. 

i i i . Take the EDO dump. 

iv. Do a level 3 NOS deadstart. 

Alternatively the operator can skip step i if 
she/he is sure to redeadstart NOS/VE after step 
iv. In this event the system will detect that the 
image file was never created* will create one* and 
will recover from it. 
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The System Core debugger provides a set of capabilities 
Intended to assist in debugging the operating system* 
Services provided by the debugger are task oriented* selection 
of the tasks to be debugged must be wade via debugger 
subcommands. No tasks wi I I be under control of the debugger 
unless they are selected. The selection capability allows any 
number of tasks to be debugged simultaneously; from one task 
to all tasks in the system* Obviously a capability this 
powerful must be used with some care* The System Core 
debugger uses the debug hardware to provide these 
capabi I (ties. 

6*i sxsaEaus 

The purpose of this command Is to initiate execution of the 
system core debugger* This command can be issued from the 
deadstart command file or as a command in any job. 

sysdebug 

This command has no parameters; all information the 
debugger requires is provided via subcommands. 

The system core debugger can also be invoked from the MOD 
console* The format of the command is* 

DO n. sysdebug 

where n is the job ordinal of the desired job* The debugger 
is brought up In the job monitor task of the job* All system 
core debugger subcommands are available* but must be prefixed 
by the HDD command DO* 

The system core debugger can also be brought up Cfrom the 
MOD console) by specifying a global task id* The format of 
the command is* 

DO n*tdebug gggggg 

The value of n Is ignored* and the value gggggg specifies the 
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NQS/VE global task Id <3 hex bytesi of the task to feting the I 

debugger up in* If the task id Is invalid* then the command I 

» 



will be I gnored* 
6,2 SUa£flafiAlifi-£A&A!l£I£&-Q££U.IIIQIiS 



<name> s s * 1-8 character breakpoint name 

<conditlon> 22 = READ? WRITE? RNZS BRANCH I CALL I DIVFLT? ARLOS I 

AROVFLSEXQVFLJEXUNFLJFPLQSIFPINDEFIINVBOP 
<base> 52* process virtual address 
<offset> :i= integer 
<length> s: = integer 
<frame> *:* 1..1O0 
<count> 5 2* !• .10000 
<regid> 55= X?A?P 
<regno> 2? = 0. .15? 0. .OF < 16) 
<value> 52* integer 
<time> s;= 1*.<2**31)-1 
<vstring> ss* 'charstring 1 
<datatype> 52* HEX? ASCII ? ASC J OEC 
<change_count> 22* 1..8 
<selector> 22 = FULL? AUTO ISAVE 



6 . 3 Sxmii-£0££-fi£aUfiG£&-Silfi£QllBAMI.S 

Within the descriptions which follow* optional parameters 
are enclosed in brackets. Default values for optional 
parameters are also defined* 

6*3.1 SELECT 



The purpose of this subcommand is to select the tasks In 
which the system core debugger is to be active* When the 
debugger is first called* It is not active In any task. To 
use the debugger therefore* it is necessary to select the 
tasks In which it is to beactive* 

select <selection option> C<ring number > * <active job list 
ordlnal>1 

sel ection.opt ion: This parameter specifies one of a 
series of selection options used to control the 
tasks in which the debugger will be active and some 
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other debug options* The selections are remain In 
effect until they are explicitly changed with 
subsequent SELECT subcommands • Valid selection 
options are: 

<right1left> - This selects the screen for the debug 
display* The display stays active when the screen 
is switched* 

< jobnoni tor »no jobmoni tor> - This selects whether or 
not to debug job monitor tasks* 

<user * nouser> - This selects whether or not to debug 
user tasks Cl*e* those that are not Job 
ffloni tors) • 

<highring> - This specifies the highest ring in 

which debug traps will be recognised* Traps 

occurring in rings above this selection will be 
i gnor ed* 

<job»nojob> - This enables or disables debugging for 
the job at the specified active job list 
ordinal* The system job has an active Job list 
ordinal of zero* 

<al I jobsSno jobs> - This activates or deactivates 
debugging in all jobs* 

The initial selections are: RIGHT. N0STEP# 
NQJOBNONITQR* NOUSER, HIGHRING«3» N0408S. 



6*3.2 BREAKPOINT 5 8 



The purpose of this subcommand is to selects a program 
interrupt which is to occ specified condition within a 
specified virtual address range* 

breakpoint <narae> <condition> t<base>l C<offset>3 C<length>l 

The <name> is any user supplied name for identifying the 
breakpoint* A maximum of thirty two breakpoints can be 
selected* When a trap occurs* the <naie> of the breakpoint 
which caused the trap is displayed* 

The base parameter is required when specifying a new 
breakpoint name; offset and length specifications are optional 
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6.3*2 BREAKPOINT ? B 



in this case. When adding a new condition selection to an 
existing breakpoint* base* offset* and length parameters may 
not be specified* 

Base* offset* and length parameters define the desired 

virtual address range: <fease> + <offset> yields a 

f I rst-byte-address j first-byte-address + <length> -1 yields a 
I as t byte address* 



Default parameter values? 

<offset>* 
<iength>: 1 



6.3.3 REMQVE_BREAKPQINT 1 RB 



The purpose of this subcommand is to deselect a previously 
selected program Inte 

remove_br eakpoint <name> £<condi ti on>3 

If only the name parameter is specified* all conditions 
associated with the breakpoint are deselected and all evidence 
of the breakpoint is removed. If the condition parameter is 
specified* only that condition is deselected! however* if the 
specified condition is the only condition selected* alt 
evidence of the named breakpoint is removed. 



6.3.4 LIST.BREAKPOINT i I! 



The purpose of this subcommand is to provide a list of 
currently selected breakp and associated conditions. 

I i st_br eakpoint £<name>l 

If the name parameter is specified* information is 
displayed for the named breakpoint only. If the name 
parameter is not specified* information is displayed for all 
currently defined breakpoints* 



Cycle 5* July 1982 



6-5 
NOS/VE Cycle 5 Helpful Hints 

6,0 SYSTEH CORE DEBUGGER 
6*3.5 CHANGE BREAKPOINT \ C8 



6*3,5 CHANGE_BR£AKPOINT J CB 



The purpose of this subcommand Is to change the virtual 
address range of a previ specified breakpoint* 

change.breakpolnt <name> <base> t<offset>3 C<length>l 

8ase» offset* and length parameters define the desired 

virtual address ranges <base> + <offset> yields a 

first-byte-address- first-byte-address ♦ <length> -1 yields a 
last byte address* 

Default parameter values? 

<offset>J 
<length>s \ 



6.3.6 TRACE3ACK I T8 



The purpose of this subcommand is to provide information 
relevant to stack frame associated with an interrupted 
procedure and its predecessor procedures* Validation of PVAVs 
is now performed. 

Information displayed for each selected stack frame 
const sts of: 

- Stack frame number J 

- Current P-address of the associated procedure? 

- Virtual address of the start of the stack frame, 

- Virtual address of the stack frame save area* 

trace.back t<frame>] C<count>l CFUtLi SHORT! 

The frame parameter specifies the number of the first stack 
frame for which information is to be displayed* Stack frame 
number one is associated with the interrupted procedure* stack 
frame two is associated with the interrupted procedure's 
predecessor* etc. 

The module name provided on the traceback is usually 
correct but not guaranteed* 

The count parameter specifies the total number of stack 
frames for which information is to be displayed* 
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6.3.6 TRACE. BACK I T8 



Default parameter values? 

<frame>J 1 
<count>« I 



6.3.7 DISPIAY.STACK.FRAHE I DSF 



The purpose of this subcommand is to display selected 
information from a specifi stack frame. 

di spl ay.stack.f rame t<frame>3 t<selector>3 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed. (Stack frame number 
one is associated with the interrupted procedure* stack frame 
two is associated with the interrupted procedure's 
predecessor* etc.) 

The selector parameter identifies a region of the specified 
stack frames 

AUTOs Causes the automatic region of the stack frame to be 
d I sp I ayed. 

SAVE! Causes the save area of the stack frame to be 
di spl ayed. 

FULL* Causes both the automatic and save areas of the stack 
frame to be displayed. 

Default parameter values* 

<frame>5 1 
<seiector>: FULL 



6.3.8 DISPLAY.REGISTER J OR 

The purpose of this subcommand is to display the contents 
of a specified registe interrupted procedure. 

di spl ay. regis ter <regid> C<regno>3 C<datatype>3 

Default parameter values: 

<regno>s 
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<datatype>: HEX 

6.3.9 DISPLAY_MEMORY \ DM 

The purpose of this subcommand is to display the contents 
of a specified area of virtual memory* Validation of PVA's is 
now performed. 

displ ay.memcry <base> C<length>3 

Default parameter values? 

<!engtf»>* 8 

6.3.10 CHAMGE.MEMORY ! CM 

The purpose of this subcommand is to set a specified value 
into a specified loca of virtual memory for a specified number 
of bytes. Validation of PVA f s Is now performed. 

change^memory <base> <value> <change_count> 

Default parameter values? 

<change_count>: 1 

6.3.11 RUN 



The purpose of this subcommand is to Invoke program 
execution after a selected p interrupt has occurred. 

run 



6.3.12 SUPER.CHAN6E. MEMORY 5 SCM 



The purpose of this subcommand is the same as the change 
memory subcommand* that Is* to change the contents of virtual 
memory. It differs from change memory* however* in that it 
will change the attributes of the segment to allow memory to 
be written* and then change the attributes back to their 
original values. 
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6.0 SYSTEM CORE DEBUGGER 

6.3,12 SUPER.CHANGE.MEMGRY % SCM 

The command format Is the saie as the change memory 
subcommand* 



6.3.13 FORMAT \ FMT 

The purpose of this subcommand Is to set the system core 
debugger into a mode where all subcommand output is sent to a 
permanent file. This is done by having the task running the 
debugger communicate with another task running in the system 
job. It is this other task that actually creates and writes 
the permanent file. The entry point of this task is 
GSP$8RQKEN_JGBJ)UMP_TA$K. It will normally be initiated by 
the D$ procedure. If it is not running, a diagnostic will be 
issued. This task will create successive cycles of the 
permanent file f DUMP* in the SSYSTEM catalog. These files 
contain ASCII text data written in BAM variable records* The 
parameter to this command is a string which will be output as 
the first line of the file. 

format string 

6.3.14 UNFQRMAT J UNFMT 



The purpose of this subcommand is to leave the output mode 

established by the FORMAT command. Output will again be sent 

to the operator console. At this point the permanent file 

will be flushed to mass storage. 

unf ormat 



6.3.15 DISPLAY_M0NIT0R_FAULT S OISMF I 

The purpose of this subcommand is to display any monitor 1 

faults present in this task. See the section titled «N0S/V£ } 

Processing of Job Mode Software Errors 1 for more information* * 

Ail monitor fault buffers are displayed in the hope they X 

will show some task history. If a given fault buffer is \ 

invalid the message "following fault is not present** Is ? 

displayed. 1 

dl spl ay.monl tor_f aul t I 
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6.3.16 DISPLAY. XC8 J OISXCB 



The purpose of this subcommand 
fields of the current task's (i.e.* 
debugger) execution control block* 



is to display all of the 
the task running the 



6.3.17 DI$PLAY_TA$K_ENVXROMMENT S OISTE 



The purpose of this subcommand is to display the XCB of all 
tasks running within the current job (I.e.* the job with the 
task running the debugger). If the command is entered while 
the debugger is in format iode^ then a full XCB is displayed* 
otherwise just the task name* XCB address and global task Id 
are displayed. 
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7 . HQ5ZM£-£aQC£SSItlfi-aE-iafl-ttQa£-aQEIMA&£-£R&aaS 



7.1 iiii&QiaiciiQii 



Tasks running in job mode will occasionally cause an error 
which is detected either by the hardware or NOS/VE monitor* 
The action taken Mhen an error like this occurs is controlled 
by various system attributes* The purpose of this section is 
to discuss the types of errors and the effect a given system 
attribute Mill have upon the handling of the error* 



7*2 imS-QE-ERfiQES 



1) BROKEN TASKS A broken task is a task In which the trap 
mechanise is not able to function correctly* NOS/VE 
monitor will attempt to repair the trap mechanism and send 
a broken task fault to the task* The specific cases of a 
broken task ares 

system error job mode software has 

declared the task to be 
broken* (This is a special 
case of broken task*) 

monitor fault buffer full job mode errors are 

occur ing but are not being 
processed by job mode* 

traps disabled a job mode error has 

occurred while traps were 
di sab I ed* 

invalid AO the task's AO register was 

invalid* 

UCR/HCR traps disabled UCR/NCR error occurred with 

traps disabled* 

Z) MCR FAULT? This error signifies that job mode caused a 
hardware detected NCR fault* This may be caused by 
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7,0 NOS/VE PROCESSING OF JOB HOOE SOFTWARE ERRORS 

7,2 TYPES OF ERRORS 



software or hardware detected uncorrectable error* 

3) UNKNOWN SYSTEM REQUEST: This error signifies that job mode 
issued a monitor request that is either invalid or cannot 
be issued from the ring It was issued from* 

4) SEGMENT ACCESS FAULTS: These errors signify that job mode 
encountered or caused one of the following errors: 

- page fault for an address greater than EQI on a 
read-only file (segment) 

- disk read error 

These errors either originate In NOS/VE monitor or cause 
the hardware to exchange to monitor. Depending on the values 
of certain system attributes* monitor will halt or reflect the 
error back to job mode as a monitor default* 

It is at this point that the system core debugger can be 
activated. (See the definition of SYSTEM_DEBUG_RING in the 
next sect i on* ) 

The normal job mode OS actions for these faults are: 

broken task exi t 

HCP fault cause condition 

invalid system request exit 

segment access cause condition 



7 * 3 SISI£tt-AmiaUIES-EQ£-E&&Q&.E&QCESSlH£ 



The following system attributes can be set or displayed by 
the SETSA and OISSA commands. 



7.3.1 HALTRING 



If a broken task or MCR fault occurs at or below the value 
of HALTRING (P register ring number)* NOS/VE monitor will halt 
the system* Broken tasks occurring above HALTRING will cause 
a monitor fault to be sent back to job mode* 
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7. 3.2 SYSTEM^ERROR.HANG.COUNT 

This is the number of broken task errors allowed to occur 
in any given task before that task is considered a hung task* 

7.3*3 HALT.ON^HUNG^TASK 

If this attribute is true* then an occurence of a hung task 
»iM cause NOS/VE monitor to halt the system* If the 
attribute Is false* the task will be sent a signal to »hang* 
itself* i.e. to go into an infinite wait doing nothing. Jobs 
with hung tasks will have a *H in the status field on the 
operator CP display. 

A hung task will also occur if any error happens in Job 

mode r Ing 1. 

7.3.4 SY5T£M_DEBUG_RING 

If an error {broken task* MCR fault* unknown system 
request* or segment access fault) occurs at or below the value 
of this attribute (P register ring number)* the system core 
debugger will be invoked within the task. At that point in 
time the task environment can be examined by using system core 
debugger commands. 

If the RUN command is issued to the debugger* the system 
will take its normal action for the specific fault* 

7.3.5 OUMP.¥HEN_DEBUG 

When the system core debugger is invoked by a fault at or 
below SYSTEH.DEBUG_.RING and the DUMP_WH£N_DEBUG attribute is 
true* the debugger will automatically create a dump of the 
task (see system core debugger command FORMAT). When the dump 
is complete* normal fault action will take place. The 
following system core debugger commands are executed during an 
automatic dump: 

FORMAT automatic dump data 

T8 i 1000 

OISMF 
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liltZ^~Z~i~l~z~l%)l%„~*.~~«~~„~~„„„ „*„„„„„„ 

OISXCB 

DH 00300000000 10000U6) 

OH 00400000000 10000(16) 

OH 00500000000 10000(16) 

OH 00600000000 10000(16) 

DM OOFOOOOOOOO 10000116) 

OM 01000000000 10000(16) 

OH 01100000000 10000(16) 

DISTE 

UNFQRMAT 
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8.0 STAND AIGNE DEADSTART 



8,0 iIMI2-ALDM£-a£42aiAEI 



Standalone deadstart does not work for Cycle 3. Code will 
be transmitted for Cycle 4 to repair this! this section will 
be rewritten then. 
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9.0 IMI£Ei£II^£.EESil£a.OUEE-i^^USI£-£EQC£aUS£S 



The following procedures were developed by the interactive 
project to assist them in Interpreting dumps* They guarantee 
the procedures work If your user name Is IFPl otherwise caveat 
emptor. For more information about these procedures* contact 
Fred Sischke* 



The following dump analysis procedures are available in the 
IFP catalog: 



9.1 



EDDSIM 

This is a CCl procedure which brings an EDO dump tape on a 
speci f i ed 

VSN into the simulator* The procedure can be accessed from 
the IFP 

catalog as fol I ows: 

get*eddsl ra/un-i f p 

begin* • edds I m* vsn { vsn is the vsn of the EDD dump tape ) 



9*2 



ANALEXC 



This is a Simulator INCLUDE file which does a preliminary 
analys Is of 

the current simulator exchange package ( when the system 
crashes In task 
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services* this will normally be JPS )• A gr exc»mon or gr 
exc=rma can be 

used to get into another exchange package before doing the 
include* 

The include file is ANALEXC/UN=IFP • It can be called from 
the simulator 

as fol I ows? 

»get»anaiexc/un»i f p 1 5 include analexc 



(carriage return) a lone carriage return must be entered 
after an INCLUDE 

in order to start it up 



9*3 



SEGDUHP 



This is a CCL procedure which calls DSDIV to dump a 
speci f i ed segment to 
a list file which can then fee examined with an editor or 
pr inted. 

The procedure can be accessed from within the Simulator as 
fol lows* 



•get^segdump/un- I f p' J *begl n*# segdump* seg* I en>f i 1 e*exc»cpf * <* 

The segdump parameters ares 
seg - segment number in hex C default is 1 ) 
length - number of bytes to dump in hex C default Is 10000 ) 
list - name of the list file ( default Is LIST ) 
exc - reference exchange package ( default is JPS ) 
cpf - name of checkpoint file ( default is CPF ) 
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In most cases of task services debugging* only the sei 
parameter Is 

needed • 



9.4 



ANAUOB 

This is a CCl procedure which uses DSDIV* XEDIT and the 
Simulator to 

perform an analysis of all tasks in a specified job* The 
procedure can 

be accessed from within the simulator as followss 
•get* anal job/un*i fp» ; f begin** ana I job* seg*cpf * 

The analjob parameters ares 

seg - the monitor segment which contains the exchange 
packages of the job { 14 is the system job* 15 Is job 1 etc* 
) t default is 14 ) 

cpf - the name of the simulator file ( default is CPF ) 

After the procedure has completed* a list of the RMA's of 
the 

job f s exchange packages can be obtained by doing the 
fol lowi ngs 

inc lude tplist 

(carriage return) 



A traceback of all tasks in the job can be obtained by 

loing the 
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9,0 INTERACTIVE PROJECT OUHP ANALYSIS PROCEDURES 
9,4 



f 61 ! o*i ngs 
include tblist 
(carriage returnl 
include tbrun 
{carriage return) 
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10.0 APDEN HILLS DEVELOPMENT LAB SUPPORT 8Y INTEGRATION 



10. 4Ea£M-aiLLS«a£i£LQ£MMI-U£-Sy£EQSI.ai-MI£SaAIIQIi 



yhat we have established in the lab so far is the following* 

- A 600 tape capacity tape rack for general use* If your 
project would like to reserve a section of this tape rack* 
contact Tip McGibbon or Bonnie Swierzbln 

-■ A tape and disk cabinet for storage of system support 
materials which this project will manage and keep up to 
date* <If you have been using this cabinet for 
unauthorized storage - beware* We have the key to the 
lock!) More will be published about the contents of this 
cabinet later* and a cabinet index will be posted in the 
lab to help locate where things are supposed to be placed 
within the cabinet. This cabinet is currently located in 
the southeast corner of the Jab* is 6 ft* 8 in* tail* 
gray in color and with sliding door* 

A microfiche reader and a metal box containing the most 

recent microfiche of the system compilation listings and a 

link map* These items are kept on the table to the right 
of the console* 

- A desk documentation rack for reference manuals and Tom 
McGee*s collection of •'how to w goodies* The objective is 
to have this reference information at arm's length of the 
console* but It is currently on top of the two-level unit 
by the West wall* 

- At or near the console is a small notebook containing the 
NQS System Programmer's Instant* NOS Application 
Programmers Instant* and the 180 Instruction codes* 



Feel free to 
In the 1 ab. 



examine and use all of the above materials while 



Do not remove or abuse any of these materials* 
Please notify Tim McGibbon or Bonnie Swierzbln 
problems or deficiencies of these materials* Leave 
we are not available* 



of any 
note if 
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